Artículos — Importar JSON

Frecuencia de actualización recomendada: 3 horas

Importa el catálogo de productos. Se envían los registros en el body de la petición como JSON.

POST/v1/articulosJSON

Campos genéricos · Request body

Campo	Tipo	Descripción
codigo	String(20)Required	Código del artículo.
descripcion	String(255)Required	Descripción del artículo.
linea	String(255)Required	Nombre de la línea del producto.
rubro	String(255)Required	Nombre del rubro del producto. Tiene mayor jerarquía que línea. Ejemplo: Rubro (Gaseosas) → Línea (Pepsi) → Artículo (Pepsi 1.5l).
capacidad	Decimal	Volumen del bulto expresado en hectolitros, si es aplicable.
pack	IntRequired	Unidades por bulto que conforman un pack. Si pack es 1, los pedidos se expresan en unidades. Si pack es mayor a 1, los pedidos se expresan en bultos.
impuestoInt	Decimal	Impuesto interno expresado en pesos [$]. Este impuesto no debe estar incluido en el precio.
topeDesc	Decimal	Tope de descuento aplicable al artículo, expresado en porcentaje.
costo	Decimal	Costo real, expresado en pesos [$] luego de realizar todos los descuentos correspondientes. Ej: acuerdo, financiero, etc.
codigoIva	Int	Código de Iva del archivo Iva. Por defecto en "1" (se aplicará 21%) si no hay archivo de Iva.
codBarra	String(13)	Código de barra en formato EAN 13.
codBarraPack	String(14)	Código de barra en formato DUN14 de la caja, si es aplicable.
marca	String(255)	Nombre de la marca del producto.
fabrica	String(255)	Nombre de la fábrica del producto.
peso	Decimal	Peso del bulto expresado en kg.
codigoGrupo	String(20)	Código del grupo al que pertenece el artículo.
grupo	String(20)	Grupo al que pertenece el artículo.
codigoProveedor	String(20)	Código del proveedor.
proveedor	String(255)	Nombre de la empresa proveedora del producto.
lista1 … lista20	String(255)	Listas de precios 1 a 20. Formato: "1000.00".
combo	Int	Indica si el código del artículo hace referencia a un combo (no hace diferencia entre combo estático y combo dinámico). 1: True \| 0: False.
esPesable	String(1)	Indica si el artículo se vende por peso (el precio es por kg). 1: True \| 0: False.
canasta	String(255)	Canasta a la cual pertenece el artículo.

Response body

Campo	Tipo	Descripción
success	BooleanRequired	Indica si la operación se procesó con éxito.
message	String	Mensaje con el resultado. Si success es false, detalla el motivo del error.

Respuestas

Código	Significado
200	Importación procesada. El campo success indica el resultado; si es false, message detalla el motivo.
403	La API key enviada en `X-API-KEY` no es válida.
404	Falta el header `X-API-KEY` o la URL es incorrecta.
429	Se superó el límite de 30 requests por minuto.
500	Error interno del servidor. Reintentar más tarde.

cURL

curl --location --request POST 'https://gateway.axum.com.ar/{tenant}/api/v1/articulos' \
  --header 'X-API-KEY: {tenant-apikey}' \
  --header 'Content-Type: application/json' \
  --data '[ ... ]'

REQUEST BODY · ESQUEMA

[
  {
    "codigo": string,
    "descripcion": string,
    "linea": string,
    "rubro": string,
    "division": string,
    "capacidad": decimal,
    "pack": int,
    "impuestoInt": decimal,
    "topeDesc": decimal,
    "costo": decimal,
    "codigoIva": int,
    "codBarra": string,
    "codBarraPack": string,
    "marca": string,
    "fabrica": string,
    "peso": decimal,
    "codigoGrupo": string,
    "grupo": string,
    "codigoProveedor": string,
    "proveedor": string,
    "combo": int,
    "esPesable": string,
    "canasta": string,
    "lista1": string,
    ...
    "lista20": string
  }
]

REQUEST BODY · EJEMPLO

[
  {
    "codigo": "1",
    "descripcion": "TACCONI PET *SERRANO 6 X 1.5 L",
    "linea": "APERITIVOS",
    "rubro": "A-APERITIVOS SIN ALCOHOL",
    "division": "BEBIDAS",
    "capacidad": 0.00,
    "pack": 6,
    "impuestoInt": 0.00,
    "topeDesc": 100.00,
    "costo": 40.36,
    "codigoIva": 1,
    "codBarra": "7790950003048",
    "codBarraPack": "57790950003043",
    "marca": "",
    "fabrica": "",
    "peso": null,
    "codigoGrupo": null,
    "grupo": null,
    "codigoProveedor": "00001",
    "proveedor": "CEPAS ARGENTINAS S.A.",
    "combo": 0,
    "esPesable": "0",
    "canasta": "Canasta 1",
    "lista1": "10.00",
    "lista2": "10.00",
    "lista5": "20.00",
    "lista6": "15.13",
    "lista15": null,
    "lista20": null
  }
]

RESPONSE · 200 OK

{
  "success": true,
  "message": "Archivo Articulos subido OK"
}