Sincronización de Productos
Sincroniza artículos. Las categorías del producto se propagan a las facturas cuando sus líneas referencian ese product_code.
Crea o actualiza productos del catálogo. Las categorías se propagan automáticamente a las facturas.
Caso de uso
- Crear catálogo de artículos desde el sistema externo.
- Actualizar peso, volumen, largo y categorías para validaciones de vehículo.
Campos del Payload
Requeridos
| Campo | Tipo | Descripción |
|---|---|---|
source_id | string | ID único en el sistema de origen |
source_system | string | Sistema externo (ej. external_erp) |
product_code | string | Código del producto |
Opcionales
| Campo | Tipo | Descripción |
|---|---|---|
is_active | boolean | Estado activo |
product_id | int | ID interno del producto |
product_description | string | Descripción del artículo |
categories | string[] / string | Categorías (arreglo o separado por comas) |
weight | number | Peso en kg |
volume | number | Volumen en m³ |
length | number | Largo en metros |
Ejemplos
Request
{
"source_id": "product.product:49626",
"source_system": "external_erp",
"product_code": "00838",
"product_description": "Adaptador PVC hembra 12 mm (1/2\")",
"categories": ["PVC", "PLOMERIA"],
"weight": 0.02,
"volume": 0.1,
"length": 1.5,
"is_active": true
}Response
{
"ok": true,
"code": "SYNC_OK",
"message": "Sync processed successfully.",
"data": 8435,
"meta": {
"route": "/transportes/sync/products",
"method": "PostProductSync",
"operation": "upsert",
"upsert_action": "updated",
"timestamp": "2026-04-07T12:00:00.000Z"
}
}