> For the complete documentation index, see [llms.txt](https://docs.zipnova.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zipnova.com/carriers/referencia-api/envios.md).

# Envíos

Lista y consulta los envíos del Carrier, sube la etiqueta e informa tracking y estados.

## GET /shipments

> Listar los envíos del Carrier

```json
{"openapi":"3.1.0","info":{"title":"Zipnova Carrier API","version":"1.0.0"},"tags":[{"name":"Shipments","description":"Envíos asignados al Carrier"}],"servers":[{"url":"https://api.zipnova.com.ar/carrier/v1","description":"Argentina (AR)"},{"url":"https://api.zipnova.cl/carrier/v1","description":"Chile (CL)"},{"url":"https://api.zipnova.com.mx/carrier/v1","description":"México (MX)"}],"security":[{"carrierApiKey":[]}],"components":{"securitySchemes":{"carrierApiKey":{"type":"http","description":"API key del Carrier, generada desde el Carrier Hub","scheme":"bearer"}},"schemas":{"CarrierShipmentResource":{"title":"Shipment","properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"status":{"description":"Código del estado actual en Zipnova","type":"string"},"status_name":{"description":"Nombre del estado actual","type":"string"},"substatus":{"description":"Código del sub-estado, si tiene","type":["string","null"]},"service_type":{"description":"Tipo de servicio","type":"string"},"logistic_type":{"description":"Tipo logístico","type":"string"},"tracking_number":{"description":"Número de seguimiento informado por el carrier","type":["string","null"]},"tracking_url":{"description":"URL de seguimiento informada por el carrier","type":["string","null"]},"has_label":{"description":"true si el carrier ya subió la etiqueta","type":"boolean"},"declared_value":{"description":"Valor declarado del envío","type":"number"},"carrier_price":{"description":"Precio informado por el carrier para este envío","type":["number","null"]},"custom_data":{"description":"Datos que el carrier devolvió en la cotización por callback","type":["object","null"]},"total_weight":{"description":"Gramos","type":"integer"},"total_volume":{"description":"cm³","type":"integer"},"estimated_delivery_at":{"description":"Fecha estimada de entrega","type":["string","null"],"format":"date-time"},"created_at":{"description":"Fecha de creación del envío","type":"string","format":"date-time"},"updated_at":{"description":"Última actualización del envío","type":"string","format":"date-time"},"seller":{"description":"Cuenta de Zipnova que despacha el envío","properties":{"account_id":{"description":"ID de la cuenta del seller","type":"integer"},"name":{"description":"Nombre del remitente o destinatario","type":"string"}},"type":"object"},"origin":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de origen (retiro)"},"destination":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de destino (entrega)"},"packages":{"description":"Bultos del envío","type":"array","items":{"properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"label_code":{"description":"Código de bulto de Zipnova","type":"string"},"weight":{"description":"Gramos","type":"integer"},"height":{"description":"cm","type":"number"},"width":{"description":"cm","type":"number"},"length":{"description":"cm","type":"number"},"description":{"description":"Descripción del contenido del bulto","type":["string","null"]}},"type":"object"}}},"type":"object"},"CarrierShipmentAddress":{"properties":{"name":{"description":"Nombre del remitente o destinatario","type":"string"},"document":{"description":"Documento (DNI/CUIT/RUT/RFC)","type":["string","null"]},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Altura","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones","type":["string","null"]},"zipcode":{"description":"Código postal. Solo se envía en los países que usan código postal (no en Chile).","type":["string","null"]},"city":{"$ref":"#/components/schemas/CarrierCity"},"phone":{"description":"Teléfono de contacto","type":["string","null"]},"email":{"description":"Email de contacto","type":["string","null"]},"latitude":{"description":"Latitud geolocalizada, si está disponible","type":["number","null"]},"longitude":{"description":"Longitud geolocalizada, si está disponible","type":["number","null"]}},"type":"object"},"CarrierCity":{"description":"Ciudad, con el mismo formato en la cotización y en el detalle de envío","properties":{"id":{"description":"ID de ciudad de Zipnova","type":"integer"},"name":{"description":"Nombre de la ciudad","type":"string"},"state":{"description":"Provincia/región","properties":{"code":{"description":"Código ISO de la provincia/región","type":["string","null"]},"name":{"description":"Nombre de la provincia/región","type":["string","null"]}},"type":"object"},"country":{"description":"Código ISO del país","type":["string","null"]}},"type":["object","null"]}}},"paths":{"/shipments":{"get":{"tags":["Shipments"],"summary":"Listar los envíos del Carrier","operationId":"25f42420c31c429067a45a9cfbdae196","parameters":[{"name":"status","in":"query","description":"Código de estado de Zipnova","required":false,"schema":{"type":"string"}},{"name":"updated_since","in":"query","description":"Solo envíos actualizados desde esta fecha (ISO 8601). Con este filtro, o con created_since, el listado va de más antiguo a más reciente (por fecha de actualización con updated_since, por fecha de creación con solo created_since) y se pagina con cursor (parámetro cursor, tomado de meta.next_cursor), para no saltear ni repetir envíos que cambian entre una página y otra","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"created_since","in":"query","description":"Solo envíos creados desde esta fecha (ISO 8601). Se puede combinar con updated_since y status","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"cursor","in":"query","description":"Solo con updated_since o created_since: el valor de meta.next_cursor de la página anterior","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Solo sin updated_since ni created_since","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Envíos paginados (50 por página)","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CarrierShipmentResource"}},"meta":{"type":"object"},"links":{"type":"object"}},"type":"object"}}}},"401":{"description":"API key inválida"},"422":{"description":"Filtros inválidos"}}}}}}
```

## GET /shipments/{shipment\_id}

> Detalle completo de un envío del Carrier

```json
{"openapi":"3.1.0","info":{"title":"Zipnova Carrier API","version":"1.0.0"},"tags":[{"name":"Shipments","description":"Envíos asignados al Carrier"}],"servers":[{"url":"https://api.zipnova.com.ar/carrier/v1","description":"Argentina (AR)"},{"url":"https://api.zipnova.cl/carrier/v1","description":"Chile (CL)"},{"url":"https://api.zipnova.com.mx/carrier/v1","description":"México (MX)"}],"security":[{"carrierApiKey":[]}],"components":{"securitySchemes":{"carrierApiKey":{"type":"http","description":"API key del Carrier, generada desde el Carrier Hub","scheme":"bearer"}},"schemas":{"CarrierShipmentResource":{"title":"Shipment","properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"status":{"description":"Código del estado actual en Zipnova","type":"string"},"status_name":{"description":"Nombre del estado actual","type":"string"},"substatus":{"description":"Código del sub-estado, si tiene","type":["string","null"]},"service_type":{"description":"Tipo de servicio","type":"string"},"logistic_type":{"description":"Tipo logístico","type":"string"},"tracking_number":{"description":"Número de seguimiento informado por el carrier","type":["string","null"]},"tracking_url":{"description":"URL de seguimiento informada por el carrier","type":["string","null"]},"has_label":{"description":"true si el carrier ya subió la etiqueta","type":"boolean"},"declared_value":{"description":"Valor declarado del envío","type":"number"},"carrier_price":{"description":"Precio informado por el carrier para este envío","type":["number","null"]},"custom_data":{"description":"Datos que el carrier devolvió en la cotización por callback","type":["object","null"]},"total_weight":{"description":"Gramos","type":"integer"},"total_volume":{"description":"cm³","type":"integer"},"estimated_delivery_at":{"description":"Fecha estimada de entrega","type":["string","null"],"format":"date-time"},"created_at":{"description":"Fecha de creación del envío","type":"string","format":"date-time"},"updated_at":{"description":"Última actualización del envío","type":"string","format":"date-time"},"seller":{"description":"Cuenta de Zipnova que despacha el envío","properties":{"account_id":{"description":"ID de la cuenta del seller","type":"integer"},"name":{"description":"Nombre del remitente o destinatario","type":"string"}},"type":"object"},"origin":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de origen (retiro)"},"destination":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de destino (entrega)"},"packages":{"description":"Bultos del envío","type":"array","items":{"properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"label_code":{"description":"Código de bulto de Zipnova","type":"string"},"weight":{"description":"Gramos","type":"integer"},"height":{"description":"cm","type":"number"},"width":{"description":"cm","type":"number"},"length":{"description":"cm","type":"number"},"description":{"description":"Descripción del contenido del bulto","type":["string","null"]}},"type":"object"}}},"type":"object"},"CarrierShipmentAddress":{"properties":{"name":{"description":"Nombre del remitente o destinatario","type":"string"},"document":{"description":"Documento (DNI/CUIT/RUT/RFC)","type":["string","null"]},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Altura","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones","type":["string","null"]},"zipcode":{"description":"Código postal. Solo se envía en los países que usan código postal (no en Chile).","type":["string","null"]},"city":{"$ref":"#/components/schemas/CarrierCity"},"phone":{"description":"Teléfono de contacto","type":["string","null"]},"email":{"description":"Email de contacto","type":["string","null"]},"latitude":{"description":"Latitud geolocalizada, si está disponible","type":["number","null"]},"longitude":{"description":"Longitud geolocalizada, si está disponible","type":["number","null"]}},"type":"object"},"CarrierCity":{"description":"Ciudad, con el mismo formato en la cotización y en el detalle de envío","properties":{"id":{"description":"ID de ciudad de Zipnova","type":"integer"},"name":{"description":"Nombre de la ciudad","type":"string"},"state":{"description":"Provincia/región","properties":{"code":{"description":"Código ISO de la provincia/región","type":["string","null"]},"name":{"description":"Nombre de la provincia/región","type":["string","null"]}},"type":"object"},"country":{"description":"Código ISO del país","type":["string","null"]}},"type":["object","null"]}}},"paths":{"/shipments/{shipment_id}":{"get":{"tags":["Shipments"],"summary":"Detalle completo de un envío del Carrier","operationId":"4d1062dc295ec61816d4b338bfa5b591","parameters":[{"name":"shipment_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Envío","content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/CarrierShipmentResource"}},"type":"object"}}}},"404":{"description":"El envío no existe o no es del Carrier"}}}}}}
```

## POST /shipments/{shipment\_id}/documents

> Subir la etiqueta (y opcionalmente la guía de despacho, waybill). Hace pasar el envío de Procesando a Pendiente de preparación.

```json
{"openapi":"3.1.0","info":{"title":"Zipnova Carrier API","version":"1.0.0"},"tags":[{"name":"Shipments","description":"Envíos asignados al Carrier"}],"servers":[{"url":"https://api.zipnova.com.ar/carrier/v1","description":"Argentina (AR)"},{"url":"https://api.zipnova.cl/carrier/v1","description":"Chile (CL)"},{"url":"https://api.zipnova.com.mx/carrier/v1","description":"México (MX)"}],"security":[{"carrierApiKey":[]}],"components":{"securitySchemes":{"carrierApiKey":{"type":"http","description":"API key del Carrier, generada desde el Carrier Hub","scheme":"bearer"}},"schemas":{"StoreShipmentDocumentsRequest":{"title":"Upload shipment documents","description":"Etiqueta 10x15 del envío (un PDF con una página por bulto), opcionalmente en ZPL, y una guía de despacho opcional. Zipnova no valida el formato: se confía en la homologación del carrier.","required":["label"],"properties":{"label":{"description":"Etiqueta en PDF","type":"string","format":"binary"},"label_zpl":{"description":"La misma etiqueta en ZPL: texto plano con una o más etiquetas ^XA…^XZ","type":["string","null"],"format":"binary"},"waybill":{"description":"Guía de despacho (waybill) en PDF","type":["string","null"],"format":"binary"}},"type":"object"},"CarrierShipmentResource":{"title":"Shipment","properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"status":{"description":"Código del estado actual en Zipnova","type":"string"},"status_name":{"description":"Nombre del estado actual","type":"string"},"substatus":{"description":"Código del sub-estado, si tiene","type":["string","null"]},"service_type":{"description":"Tipo de servicio","type":"string"},"logistic_type":{"description":"Tipo logístico","type":"string"},"tracking_number":{"description":"Número de seguimiento informado por el carrier","type":["string","null"]},"tracking_url":{"description":"URL de seguimiento informada por el carrier","type":["string","null"]},"has_label":{"description":"true si el carrier ya subió la etiqueta","type":"boolean"},"declared_value":{"description":"Valor declarado del envío","type":"number"},"carrier_price":{"description":"Precio informado por el carrier para este envío","type":["number","null"]},"custom_data":{"description":"Datos que el carrier devolvió en la cotización por callback","type":["object","null"]},"total_weight":{"description":"Gramos","type":"integer"},"total_volume":{"description":"cm³","type":"integer"},"estimated_delivery_at":{"description":"Fecha estimada de entrega","type":["string","null"],"format":"date-time"},"created_at":{"description":"Fecha de creación del envío","type":"string","format":"date-time"},"updated_at":{"description":"Última actualización del envío","type":"string","format":"date-time"},"seller":{"description":"Cuenta de Zipnova que despacha el envío","properties":{"account_id":{"description":"ID de la cuenta del seller","type":"integer"},"name":{"description":"Nombre del remitente o destinatario","type":"string"}},"type":"object"},"origin":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de origen (retiro)"},"destination":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de destino (entrega)"},"packages":{"description":"Bultos del envío","type":"array","items":{"properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"label_code":{"description":"Código de bulto de Zipnova","type":"string"},"weight":{"description":"Gramos","type":"integer"},"height":{"description":"cm","type":"number"},"width":{"description":"cm","type":"number"},"length":{"description":"cm","type":"number"},"description":{"description":"Descripción del contenido del bulto","type":["string","null"]}},"type":"object"}}},"type":"object"},"CarrierShipmentAddress":{"properties":{"name":{"description":"Nombre del remitente o destinatario","type":"string"},"document":{"description":"Documento (DNI/CUIT/RUT/RFC)","type":["string","null"]},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Altura","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones","type":["string","null"]},"zipcode":{"description":"Código postal. Solo se envía en los países que usan código postal (no en Chile).","type":["string","null"]},"city":{"$ref":"#/components/schemas/CarrierCity"},"phone":{"description":"Teléfono de contacto","type":["string","null"]},"email":{"description":"Email de contacto","type":["string","null"]},"latitude":{"description":"Latitud geolocalizada, si está disponible","type":["number","null"]},"longitude":{"description":"Longitud geolocalizada, si está disponible","type":["number","null"]}},"type":"object"},"CarrierCity":{"description":"Ciudad, con el mismo formato en la cotización y en el detalle de envío","properties":{"id":{"description":"ID de ciudad de Zipnova","type":"integer"},"name":{"description":"Nombre de la ciudad","type":"string"},"state":{"description":"Provincia/región","properties":{"code":{"description":"Código ISO de la provincia/región","type":["string","null"]},"name":{"description":"Nombre de la provincia/región","type":["string","null"]}},"type":"object"},"country":{"description":"Código ISO del país","type":["string","null"]}},"type":["object","null"]}}},"paths":{"/shipments/{shipment_id}/documents":{"post":{"tags":["Shipments"],"summary":"Subir la etiqueta (y opcionalmente la guía de despacho, waybill). Hace pasar el envío de Procesando a Pendiente de preparación.","operationId":"3348a68e56a87302d937368a778fcf56","parameters":[{"name":"shipment_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/StoreShipmentDocumentsRequest"}}}},"responses":{"200":{"description":"Documentos cargados","content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/CarrierShipmentResource"}},"type":"object"}}}},"404":{"description":"El envío no existe o no es del Carrier"},"409":{"description":"El envío ya no admite documentos, el Carrier usa Zipnova Rutas (la etiqueta la genera Zipnova) o no pudo procesarse (por ejemplo, saldo insuficiente del seller)"},"422":{"description":"Archivos inválidos"}}}}}}
```

## PUT /shipments/{shipment\_id}/tracking

> Informar el número y la URL de seguimiento del Carrier

```json
{"openapi":"3.1.0","info":{"title":"Zipnova Carrier API","version":"1.0.0"},"tags":[{"name":"Shipments","description":"Envíos asignados al Carrier"}],"servers":[{"url":"https://api.zipnova.com.ar/carrier/v1","description":"Argentina (AR)"},{"url":"https://api.zipnova.cl/carrier/v1","description":"Chile (CL)"},{"url":"https://api.zipnova.com.mx/carrier/v1","description":"México (MX)"}],"security":[{"carrierApiKey":[]}],"components":{"securitySchemes":{"carrierApiKey":{"type":"http","description":"API key del Carrier, generada desde el Carrier Hub","scheme":"bearer"}},"schemas":{"UpdateShipmentTrackingRequest":{"title":"Update shipment tracking","required":["tracking_number"],"properties":{"tracking_number":{"description":"Número de seguimiento del carrier","type":"string","maxLength":100},"tracking_url":{"description":"Página pública de seguimiento del carrier","type":["string","null"],"format":"uri"}},"type":"object"},"CarrierShipmentResource":{"title":"Shipment","properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"status":{"description":"Código del estado actual en Zipnova","type":"string"},"status_name":{"description":"Nombre del estado actual","type":"string"},"substatus":{"description":"Código del sub-estado, si tiene","type":["string","null"]},"service_type":{"description":"Tipo de servicio","type":"string"},"logistic_type":{"description":"Tipo logístico","type":"string"},"tracking_number":{"description":"Número de seguimiento informado por el carrier","type":["string","null"]},"tracking_url":{"description":"URL de seguimiento informada por el carrier","type":["string","null"]},"has_label":{"description":"true si el carrier ya subió la etiqueta","type":"boolean"},"declared_value":{"description":"Valor declarado del envío","type":"number"},"carrier_price":{"description":"Precio informado por el carrier para este envío","type":["number","null"]},"custom_data":{"description":"Datos que el carrier devolvió en la cotización por callback","type":["object","null"]},"total_weight":{"description":"Gramos","type":"integer"},"total_volume":{"description":"cm³","type":"integer"},"estimated_delivery_at":{"description":"Fecha estimada de entrega","type":["string","null"],"format":"date-time"},"created_at":{"description":"Fecha de creación del envío","type":"string","format":"date-time"},"updated_at":{"description":"Última actualización del envío","type":"string","format":"date-time"},"seller":{"description":"Cuenta de Zipnova que despacha el envío","properties":{"account_id":{"description":"ID de la cuenta del seller","type":"integer"},"name":{"description":"Nombre del remitente o destinatario","type":"string"}},"type":"object"},"origin":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de origen (retiro)"},"destination":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de destino (entrega)"},"packages":{"description":"Bultos del envío","type":"array","items":{"properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"label_code":{"description":"Código de bulto de Zipnova","type":"string"},"weight":{"description":"Gramos","type":"integer"},"height":{"description":"cm","type":"number"},"width":{"description":"cm","type":"number"},"length":{"description":"cm","type":"number"},"description":{"description":"Descripción del contenido del bulto","type":["string","null"]}},"type":"object"}}},"type":"object"},"CarrierShipmentAddress":{"properties":{"name":{"description":"Nombre del remitente o destinatario","type":"string"},"document":{"description":"Documento (DNI/CUIT/RUT/RFC)","type":["string","null"]},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Altura","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones","type":["string","null"]},"zipcode":{"description":"Código postal. Solo se envía en los países que usan código postal (no en Chile).","type":["string","null"]},"city":{"$ref":"#/components/schemas/CarrierCity"},"phone":{"description":"Teléfono de contacto","type":["string","null"]},"email":{"description":"Email de contacto","type":["string","null"]},"latitude":{"description":"Latitud geolocalizada, si está disponible","type":["number","null"]},"longitude":{"description":"Longitud geolocalizada, si está disponible","type":["number","null"]}},"type":"object"},"CarrierCity":{"description":"Ciudad, con el mismo formato en la cotización y en el detalle de envío","properties":{"id":{"description":"ID de ciudad de Zipnova","type":"integer"},"name":{"description":"Nombre de la ciudad","type":"string"},"state":{"description":"Provincia/región","properties":{"code":{"description":"Código ISO de la provincia/región","type":["string","null"]},"name":{"description":"Nombre de la provincia/región","type":["string","null"]}},"type":"object"},"country":{"description":"Código ISO del país","type":["string","null"]}},"type":["object","null"]}}},"paths":{"/shipments/{shipment_id}/tracking":{"put":{"tags":["Shipments"],"summary":"Informar el número y la URL de seguimiento del Carrier","operationId":"39a0b71c1823c59d06dd18f4207d2be8","parameters":[{"name":"shipment_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateShipmentTrackingRequest"}}}},"responses":{"200":{"description":"Tracking actualizado","content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/CarrierShipmentResource"}},"type":"object"}}}},"404":{"description":"El envío no existe o no es del Carrier"},"409":{"description":"El envío está en un estado final, o el Carrier usa Zipnova Rutas (el tracking lo administra Rutas)"},"422":{"description":"Datos inválidos"}}}}}}
```

## POST /shipments/{shipment\_id}/status

> Informar un cambio de estado. Requiere que el envío esté documentado (etiqueta subida). Los estados finales (delivered, not\_delivered, returned) no pueden modificarse.

```json
{"openapi":"3.1.0","info":{"title":"Zipnova Carrier API","version":"1.0.0"},"tags":[{"name":"Shipments","description":"Envíos asignados al Carrier"}],"servers":[{"url":"https://api.zipnova.com.ar/carrier/v1","description":"Argentina (AR)"},{"url":"https://api.zipnova.cl/carrier/v1","description":"Chile (CL)"},{"url":"https://api.zipnova.com.mx/carrier/v1","description":"México (MX)"}],"security":[{"carrierApiKey":[]}],"components":{"securitySchemes":{"carrierApiKey":{"type":"http","description":"API key del Carrier, generada desde el Carrier Hub","scheme":"bearer"}},"schemas":{"StoreShipmentStatusRequest":{"title":"Report shipment status","description":"Solo se aceptan estados una vez que el envío está documentado (etiqueta subida). failed_delivery requiere reason (rejected, receiver_absent, bad_address, dangerous_area): con receiver_absent o bad_address queda como intento de entrega y el envío todavía puede salir a reparto y entregarse; con rejected o dangerous_area pasa a devolución y ya no admite delivered. not_delivered requiere reason (lost). delivered, not_delivered y returned son finales.","required":["status"],"properties":{"status":{"description":"Estado estandarizado a informar","type":"string","enum":["received","out_for_delivery","soon_deliver","delivered","failed_delivery","not_delivered","returned"]},"reason":{"description":"Motivo, obligatorio para failed_delivery y not_delivered","type":["string","null"],"enum":["rejected","receiver_absent","bad_address","dangerous_area","lost"]},"occurred_at":{"description":"Momento del evento (ISO 8601). Por defecto, ahora.","type":["string","null"],"format":"date-time"},"message":{"description":"Comentario libre que queda en el historial del envío","type":["string","null"],"maxLength":150}},"type":"object"},"CarrierShipmentResource":{"title":"Shipment","properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"status":{"description":"Código del estado actual en Zipnova","type":"string"},"status_name":{"description":"Nombre del estado actual","type":"string"},"substatus":{"description":"Código del sub-estado, si tiene","type":["string","null"]},"service_type":{"description":"Tipo de servicio","type":"string"},"logistic_type":{"description":"Tipo logístico","type":"string"},"tracking_number":{"description":"Número de seguimiento informado por el carrier","type":["string","null"]},"tracking_url":{"description":"URL de seguimiento informada por el carrier","type":["string","null"]},"has_label":{"description":"true si el carrier ya subió la etiqueta","type":"boolean"},"declared_value":{"description":"Valor declarado del envío","type":"number"},"carrier_price":{"description":"Precio informado por el carrier para este envío","type":["number","null"]},"custom_data":{"description":"Datos que el carrier devolvió en la cotización por callback","type":["object","null"]},"total_weight":{"description":"Gramos","type":"integer"},"total_volume":{"description":"cm³","type":"integer"},"estimated_delivery_at":{"description":"Fecha estimada de entrega","type":["string","null"],"format":"date-time"},"created_at":{"description":"Fecha de creación del envío","type":"string","format":"date-time"},"updated_at":{"description":"Última actualización del envío","type":"string","format":"date-time"},"seller":{"description":"Cuenta de Zipnova que despacha el envío","properties":{"account_id":{"description":"ID de la cuenta del seller","type":"integer"},"name":{"description":"Nombre del remitente o destinatario","type":"string"}},"type":"object"},"origin":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de origen (retiro)"},"destination":{"$ref":"#/components/schemas/CarrierShipmentAddress","description":"Dirección de destino (entrega)"},"packages":{"description":"Bultos del envío","type":"array","items":{"properties":{"id":{"description":"ID del envío en Zipnova","type":"integer"},"label_code":{"description":"Código de bulto de Zipnova","type":"string"},"weight":{"description":"Gramos","type":"integer"},"height":{"description":"cm","type":"number"},"width":{"description":"cm","type":"number"},"length":{"description":"cm","type":"number"},"description":{"description":"Descripción del contenido del bulto","type":["string","null"]}},"type":"object"}}},"type":"object"},"CarrierShipmentAddress":{"properties":{"name":{"description":"Nombre del remitente o destinatario","type":"string"},"document":{"description":"Documento (DNI/CUIT/RUT/RFC)","type":["string","null"]},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Altura","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones","type":["string","null"]},"zipcode":{"description":"Código postal. Solo se envía en los países que usan código postal (no en Chile).","type":["string","null"]},"city":{"$ref":"#/components/schemas/CarrierCity"},"phone":{"description":"Teléfono de contacto","type":["string","null"]},"email":{"description":"Email de contacto","type":["string","null"]},"latitude":{"description":"Latitud geolocalizada, si está disponible","type":["number","null"]},"longitude":{"description":"Longitud geolocalizada, si está disponible","type":["number","null"]}},"type":"object"},"CarrierCity":{"description":"Ciudad, con el mismo formato en la cotización y en el detalle de envío","properties":{"id":{"description":"ID de ciudad de Zipnova","type":"integer"},"name":{"description":"Nombre de la ciudad","type":"string"},"state":{"description":"Provincia/región","properties":{"code":{"description":"Código ISO de la provincia/región","type":["string","null"]},"name":{"description":"Nombre de la provincia/región","type":["string","null"]}},"type":"object"},"country":{"description":"Código ISO del país","type":["string","null"]}},"type":["object","null"]}}},"paths":{"/shipments/{shipment_id}/status":{"post":{"tags":["Shipments"],"summary":"Informar un cambio de estado. Requiere que el envío esté documentado (etiqueta subida). Los estados finales (delivered, not_delivered, returned) no pueden modificarse.","operationId":"5fba0d1c279e2f76234c2d56c8fdd7cd","parameters":[{"name":"shipment_id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreShipmentStatusRequest"}}}},"responses":{"200":{"description":"Estado actualizado","content":{"application/json":{"schema":{"properties":{"data":{"$ref":"#/components/schemas/CarrierShipmentResource"}},"type":"object"}}}},"404":{"description":"El envío no existe o no es del Carrier"},"409":{"description":"El envío todavía no está documentado, está en un estado final o el cambio no está permitido"},"422":{"description":"Estado o motivo inválido, u occurred_at anterior a la creación del envío"}}}}}}
```