Sincronización de Devoluciones
Sincroniza devoluciones contra una factura existente en el sistema.
Crea o actualiza una solicitud de devolución asociada a una factura.
Caso de uso
- Crear solicitud de devolución asociada a factura.
- Actualizar líneas de devolución desde el sistema externo.
Campos del Payload
Requeridos
| Campo | Tipo | Descripción |
|---|---|---|
source_id | string | ID único del registro en el sistema de origen |
source_system | string | Identificador del sistema externo (ej. external_erp) |
receipt_source_id / receipt_id / receipt_code | string/int | Al menos una referencia a la factura |
lines | array | Líneas de devolución |
Opcionales
| Campo | Tipo | Descripción |
|---|---|---|
return_id | int | ID interno de la devolución |
receipt_model | string | Modelo del registro de factura |
status_id | int | Estado de la devolución |
requester | string | Nombre del solicitante |
classification_description | string | Descripción del tipo de devolución |
reason | string | Motivo de la devolución |
is_express | boolean | Indica si es una devolución urgente |
dispatch_id | int | Guía asociada |
product_model | string | Modelo de producto |
replace_lines | boolean | Reemplaza líneas existentes. Default: true |
Campos de lines[]
| Campo | Tipo | Descripción |
|---|---|---|
product_code | string | Código del producto |
quantity | number | Cantidad a devolver (mayor que 0) |
Ejemplos
Request
{
"source_id": "return.request:84",
"source_system": "external_erp",
"receipt_source_id": "account.move:10001",
"receipt_model": "account.move",
"requester": "Cliente",
"classification_description": "Producto dañado",
"reason": "Artículo quebrado",
"is_express": false,
"replace_lines": true,
"lines": [
{
"product_code": "00838",
"quantity": 1
}
]
}Response
{
"ok": true,
"code": "SYNC_OK",
"message": "Sync processed successfully.",
"data": 84,
"meta": {
"route": "/transportes/sync/returns",
"method": "PostReturnSync",
"operation": "upsert",
"upsert_action": "created",
"timestamp": "2026-04-07T12:00:00.000Z"
}
}