Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Dar de alta un producto

POST https://api.afer.pro/api/v1/products
Alias en castellano (v0, sigue operativo): 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.

Autenticación

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.

descripcionstring
obligatorio
Nombre del producto, tal y como sale en los documentos.
referenciastring
opcional
Código de referencia interno. Es lo que evita duplicados.
codigo_eanstring
opcional
Código de barras EAN. También evita duplicados.
skustring
opcional
SKU.
familiaIdstring|integer
opcional
Familia del producto.
taxonomiasarray
opcional
Lista de taxonomiaId. Puede llevar varias y de distintos tipos.
precionumber
opcional
Precio de venta sin IVA (tarifa 1).
costenumber
opcional
Coste del producto.
ivanumber
opcional
IVA en % (0, 4, 10, 21…).
stock_minimonumber
opcional
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

200 · application/json
{
    "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"
            }
        ]
    }
}
Notas
  • No duplica: si ya hay un artículo de tu cuenta con esa referencia o ese codigo_ean devuelve el que había con ya_existia: true y el motivo.
  • Admite la cabecera X-IDEMPOTENCY-KEY.
  • Para clasificar un producto que ya existe, usa etiquetarProducto.