Organización
Paquetes
Exporta los paquetes de la empresa en JSON.
GET /org-api/v1/packagesPermiso: packages:read. El listado trae como máximo 500 paquetes, del más reciente al más antiguo. No incluye comentarios internos de administración ni metadatos de IA.
Envoltorio
| Atributo | Tipo | Descripción |
|---|---|---|
| data | array | Paquetes exportados. |
| total | number | Cantidad de objetos en data. |
| exportedAt | string | Fecha ISO 8601 de la exportación. |
Atributos del paquete
| Atributo | Tipo | Descripción |
|---|---|---|
| id | string | UUID del paquete. |
| packageType | string | Prefijo interno del recibo. |
| serialNumber | number | null | Secuencia del recibo en la oficina de creación. |
| receiptPackageIndex | number | Índice dentro del recibo. 1 es P1. |
| receiptNumber | string | null | Código de recibo. Secuencia WR o warehouse externo, por ejemplo WHR…. |
| packageNumber | string | null | Código de paquete: recibo más P1, P2…. |
| trackingNumber | string | null | Número de rastreo visible. |
| trackingNormalized | string | null | Rastreo en mayúsculas y sin espacios. |
| weight | number | Peso en la unidad del recibo. |
| weightUnit | string | null | kg o lb. Null usa la unidad de la empresa. |
| volumetricWeight | number | Peso volumétrico. |
| chargeableWeight | number | Peso cobrable. |
| declaredValue | number | Valor declarado. |
| height | number | Alto. |
| width | number | Ancho. |
| length | number | Largo. |
| dimensionUnit | string | null | cm o in. |
| pieces | number | Cantidad de piezas. |
| comments | string | Descripción de la mercancía. |
| warehouseComments | string | null | Comentario de bodega. |
| isConsolidated | boolean | True si el paquete está consolidado. |
| isGrouped | boolean | True si entró en un lote de varios paquetes. |
| registrationDate | string | Fecha de registro, ISO 8601. |
| createdAt | string | Fecha de creación del registro, ISO 8601. |
| updatedAt | string | Fecha de la última actualización, ISO 8601. |
| itemStatus | object | null | Estado operativo del paquete. |
| customer | object | null | Destinatario. |
| shipper | object | null | Remitente. |
| location | object | null | Oficina o bodega actual. |
| warehouse | object | null | Bodega asociada. |
JSON de retorno
{
"data": [
{
"id": "c3a1e8b2-6f40-4a11-9d22-1b0c7e5a44d8",
"packageType": "WR",
"serialNumber": 1204,
"receiptPackageIndex": 1,
"receiptNumber": "WR00001204",
"packageNumber": "WR00001204P1",
"trackingNumber": "1Z999AA10123456784",
"trackingNormalized": "1Z999AA10123456784",
"weight": 4.5,
"weightUnit": "lb",
"volumetricWeight": 5.1,
"chargeableWeight": 5.1,
"declaredValue": 80,
"height": 20,
"width": 15,
"length": 30,
"dimensionUnit": "cm",
"pieces": 1,
"comments": "Ropa",
"warehouseComments": null,
"isConsolidated": false,
"isGrouped": false,
"registrationDate": "2026-10-20T15:04:00.000Z",
"createdAt": "2026-10-20T15:04:11.000Z",
"updatedAt": "2026-10-24T12:10:00.000Z",
"itemStatus": { "id": "st_recibido", "name": "Recibido" },
"customer": null,
"shipper": null,
"location": null,
"warehouse": null
}
],
"total": 1,
"exportedAt": "2026-10-24T17:15:00.000Z"
}Escritura
El alta, la lectura de uno, el cambio y el borrado están en Crear paquete y Un paquete. Una clave con packages:read puede listar. Escribir pide packages:write o organization:read.