Dar de alta un producto
https://api.afer.pro/api/v1/products
POST https://api.afer.pro/crearProducto
Crea un producto en el catálogo con su familia y sus taxonomías.
La familia sale de consultarFamilias o de crearFamilia, y las taxonomías de consultarTaxonomias o de crearTaxonomia: tienen que existir antes.
El precio se guarda en la tarifa 1, que es la de serie. Para el resto de tarifas, de momento, hay que entrar en el panel.
Se valida todo antes de escribir: si una taxonomía no es de tu cuenta, el producto no se queda creado a medias.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación con API key: sin credenciales responde 401.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
descripcionstringobligatorio | Nombre del producto, tal y como sale en los documentos. |
referenciastringopcional | Código de referencia interno. Es lo que evita duplicados. |
codigo_eanstringopcional | Código de barras EAN. También evita duplicados. |
skustringopcional | SKU. |
familiaIdstring|integeropcional | Familia del producto. |
taxonomiasarrayopcional | Lista de taxonomiaId. Puede llevar varias y de distintos tipos. |
precionumberopcional | Precio de venta sin IVA (tarifa 1). |
costenumberopcional | Coste del producto. |
ivanumberopcional | IVA en % (0, 4, 10, 21…). |
stock_minimonumberopcional | Stock mínimo para los avisos de bajo mínimo. |
Ejemplo de petición
curl -X POST 'https://api.afer.pro/api/v1/products' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET' \
-H 'Content-Type: application/json' \
-d '{
"descripcion": "Taladro percutor 750W",
"referencia": "TAL-750",
"familiaId": "dEf456…",
"taxonomias": [
"aBc123…"
],
"precio": 89.9,
"iva": 21
}'
<?php
$data = [
'descripcion' => 'Taladro percutor 750W',
'referencia' => 'TAL-750',
'familiaId' => 'dEf456…',
'taxonomias' => [
0 => 'aBc123…',
],
'precio' => 89.9,
'iva' => 21,
];
$ch = curl_init('https://api.afer.pro/api/v1/products');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
'Content-Type: application/json',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/products', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
},
body: JSON.stringify({
"descripcion": "Taladro percutor 750W",
"referencia": "TAL-750",
"familiaId": "dEf456…",
"taxonomias": [
"aBc123…"
],
"precio": 89.9,
"iva": 21
})
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"articuloId": "gHi789…",
"referencia": "TAL-750",
"descripcion": "Taladro percutor 750W",
"familia": {
"familiaId": "dEf456…",
"titulo": "Ferretería"
},
"iva": 21,
"precios": [
{
"tarifa": 1,
"precio": 89.9,
"precio_con_iva": null
}
],
"ya_existia": false,
"taxonomias": [
{
"taxonomiaId": "aBc123…",
"titulo": "Bosch",
"tipoId": 11,
"tipo": "Marca"
}
]
}
}
- No duplica: si ya hay un artículo de tu cuenta con esa
referenciao esecodigo_eandevuelve el que había conya_existia: truey elmotivo. - Admite la cabecera
X-IDEMPOTENCY-KEY. - Para clasificar un producto que ya existe, usa etiquetarProducto.