# Gestión de ordenes y envíos

Una vez que se cree una orden de marketplace, se creará, luego de unos segundos y en forma automática, un envío en Zipnova a partir de ella.

## Listar órdenes

> Retorna un listado paginado de órdenes de la cuenta autenticada. Si el usuario autenticado es propietario de un marketplace, también se incluyen los órdenes de todas las cuentas vendedoras asociadas, filtrados a ese marketplace.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Ventas","description":"Gestión de ventas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"OrderApiResource":{"title":"Pedido","description":"Representa un pedido de marketplace y sus detalles de envío asociados.","properties":{"id":{"description":"Identificador único del pedido","type":"integer"},"account_id":{"description":"ID de la cuenta vendedora propietaria del pedido","type":"integer"},"channel":{"description":"Información del canal de venta","properties":{"type":{"description":"Tipo de canal (ej. marketplace)","type":"string"},"marketplace":{"description":"Código del marketplace","type":"string","nullable":true},"created_at":{"description":"Fecha de creación del pedido en el canal","type":"string","format":"date-time"},"paid_at":{"description":"Fecha de pago del pedido en el canal","type":"string","format":"date-time","nullable":true},"data":{"description":"Datos adicionales específicos del canal","type":"object","nullable":true}},"type":"object"},"completed_at":{"description":"Fecha y hora en que el pedido fue marcado como completado (pago confirmado)","type":"string","format":"date-time","nullable":true},"shipment_requested_at":{"description":"Fecha y hora en que se solicitó la creación del envío para este pedido","type":"string","format":"date-time","nullable":true},"saved_origin_id":{"description":"ID de la dirección del libro de direcciones utilizada como origen del envío","type":"integer","nullable":true},"logistic_type":{"description":"Código del tipo logístico (ej. cross_docking, fulfillment)","type":"string","nullable":true},"carrier_id":{"description":"ID del transportista asignado a este pedido","type":"integer","nullable":true},"service_type_id":{"description":"ID del tipo de servicio asignado a este pedido","type":"integer","nullable":true},"destination":{"oneOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true,"description":"Dirección de destino de entrega"},"items":{"description":"Ítems del pedido","type":"array","items":{"properties":{"id":{"description":"ID del ítem","type":"integer"},"qty":{"description":"Cantidad pedida","type":"integer"},"unit_price":{"description":"Precio unitario del ítem","type":"number"},"currency":{"description":"Código de moneda (ISO 4217)","type":"string"},"product_id":{"description":"ID interno del producto si está vinculado al catálogo","type":"integer","nullable":true},"data":{"description":"Datos del producto provenientes del pedido (SKU y nombre)","properties":{"sku":{"description":"SKU del producto","type":"string"},"name":{"description":"Nombre del producto","type":"string"}},"type":"object","nullable":true}},"type":"object"}},"total_paid_amount":{"description":"Monto total pagado por el comprador","type":"number","nullable":true},"total_shipping_paid_amount":{"description":"Monto de envío pagado por el comprador","type":"number","nullable":true},"currency":{"description":"Código de moneda del pedido (ISO 4217)","type":"string","nullable":true},"tags":{"description":"Etiquetas asociadas al pedido","type":"array","items":{"type":"string"},"nullable":true},"shipments":{"description":"Envíos vinculados a este pedido (solo se incluyen cuando se cargan explícitamente)","type":"array","items":{"properties":{"id":{"description":"ID del envío","type":"integer"},"external_id":{"description":"ID de seguimiento externo del transportista","type":"string","nullable":true},"tracking_id":{"description":"ID de seguimiento de Zipnova","type":"string"},"status":{"description":"Código del estado actual del envío","type":"string"},"tracking_url":{"description":"URL pública de seguimiento","type":"string"}},"type":"object"}},"created_at":{"description":"Fecha y hora en que se creó el registro en Zipnova","type":"string","format":"date-time"},"updated_at":{"description":"Fecha y hora de la última actualización del registro","type":"string","format":"date-time"}},"type":"object"},"Address":{"title":"Dirección de orden","description":"Definición de una dirección utilizada en órdenes y envíos","properties":{"id":{"description":"Identificador","type":"integer"},"name":{"description":"Nombre","type":"string"},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Número","type":"string"},"street_extras":{"description":"Extras (piso, dpto, etc.)","type":"string"},"zipcode":{"description":"Código postal","type":"string"},"phone":{"description":"Teléfono","type":"string"},"email":{"description":"Correo electrónico","type":"string"},"document":{"description":"Documento/CUIT","type":"string"},"city":{"description":"Ciudad/Localidad/Comuna","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"description":"Provincia/Región/Estado","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"country":{"description":"País","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"location_latitude":{"description":"Latitud","type":"number"},"location_longitude":{"description":"Longitud","type":"number"},"location_type":{"description":"Tipo de ubicación","type":"string","nullable":true},"location_metadata":{"description":"Metadata de ubicación","type":"string","nullable":true},"is_accurate":{"description":"Indica si la geocodificación es precisa","type":"boolean","nullable":true},"created_at":{"description":"Fecha de creación","type":"string","format":"date-time"},"updated_at":{"description":"Fecha de última actualización","type":"string","format":"date-time"},"confirmed_at":{"description":"Fecha de confirmación de ubicación","type":"string","format":"date-time","nullable":true}},"type":"object"}}},"paths":{"/orders":{"get":{"tags":["Ventas"],"summary":"Listar órdenes","description":"Retorna un listado paginado de órdenes de la cuenta autenticada. Si el usuario autenticado es propietario de un marketplace, también se incluyen los órdenes de todas las cuentas vendedoras asociadas, filtrados a ese marketplace.","operationId":"d55dbe056043d595780e85f76f1c5b67","parameters":[{"name":"account_id","in":"query","description":"Filtrar por una cuenta vendedora específica. Debe ser una cuenta a la que el usuario autenticado tenga acceso.","required":false,"schema":{"type":"integer"}},{"name":"marketplace","in":"query","description":"Filtrar por código de marketplace (ej. meli, shopify).","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Número de página para la paginación (50 órdenes por página).","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Listado paginado de órdenes","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/OrderApiResource"}},"links":{"properties":{"first":{"type":"string"},"last":{"type":"string"},"prev":{"type":"string","nullable":true},"next":{"type":"string","nullable":true}},"type":"object"},"meta":{"properties":{"current_page":{"type":"integer"},"from":{"type":"integer"},"last_page":{"type":"integer"},"per_page":{"type":"integer"},"to":{"type":"integer"},"total":{"type":"integer"}},"type":"object"}},"type":"object"}}}},"401":{"description":"No autenticado."},"403":{"description":"Permisos insuficientes. Se requiere el permiso orders.view."}}}}}}
```

## Obtener órden

> Retorna el detalle completo de un órden específico. El usuario autenticado debe tener acceso a la cuenta propietaria de la órden.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Ventas","description":"Gestión de ventas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"OrderApiResource":{"title":"Pedido","description":"Representa un pedido de marketplace y sus detalles de envío asociados.","properties":{"id":{"description":"Identificador único del pedido","type":"integer"},"account_id":{"description":"ID de la cuenta vendedora propietaria del pedido","type":"integer"},"channel":{"description":"Información del canal de venta","properties":{"type":{"description":"Tipo de canal (ej. marketplace)","type":"string"},"marketplace":{"description":"Código del marketplace","type":"string","nullable":true},"created_at":{"description":"Fecha de creación del pedido en el canal","type":"string","format":"date-time"},"paid_at":{"description":"Fecha de pago del pedido en el canal","type":"string","format":"date-time","nullable":true},"data":{"description":"Datos adicionales específicos del canal","type":"object","nullable":true}},"type":"object"},"completed_at":{"description":"Fecha y hora en que el pedido fue marcado como completado (pago confirmado)","type":"string","format":"date-time","nullable":true},"shipment_requested_at":{"description":"Fecha y hora en que se solicitó la creación del envío para este pedido","type":"string","format":"date-time","nullable":true},"saved_origin_id":{"description":"ID de la dirección del libro de direcciones utilizada como origen del envío","type":"integer","nullable":true},"logistic_type":{"description":"Código del tipo logístico (ej. cross_docking, fulfillment)","type":"string","nullable":true},"carrier_id":{"description":"ID del transportista asignado a este pedido","type":"integer","nullable":true},"service_type_id":{"description":"ID del tipo de servicio asignado a este pedido","type":"integer","nullable":true},"destination":{"oneOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true,"description":"Dirección de destino de entrega"},"items":{"description":"Ítems del pedido","type":"array","items":{"properties":{"id":{"description":"ID del ítem","type":"integer"},"qty":{"description":"Cantidad pedida","type":"integer"},"unit_price":{"description":"Precio unitario del ítem","type":"number"},"currency":{"description":"Código de moneda (ISO 4217)","type":"string"},"product_id":{"description":"ID interno del producto si está vinculado al catálogo","type":"integer","nullable":true},"data":{"description":"Datos del producto provenientes del pedido (SKU y nombre)","properties":{"sku":{"description":"SKU del producto","type":"string"},"name":{"description":"Nombre del producto","type":"string"}},"type":"object","nullable":true}},"type":"object"}},"total_paid_amount":{"description":"Monto total pagado por el comprador","type":"number","nullable":true},"total_shipping_paid_amount":{"description":"Monto de envío pagado por el comprador","type":"number","nullable":true},"currency":{"description":"Código de moneda del pedido (ISO 4217)","type":"string","nullable":true},"tags":{"description":"Etiquetas asociadas al pedido","type":"array","items":{"type":"string"},"nullable":true},"shipments":{"description":"Envíos vinculados a este pedido (solo se incluyen cuando se cargan explícitamente)","type":"array","items":{"properties":{"id":{"description":"ID del envío","type":"integer"},"external_id":{"description":"ID de seguimiento externo del transportista","type":"string","nullable":true},"tracking_id":{"description":"ID de seguimiento de Zipnova","type":"string"},"status":{"description":"Código del estado actual del envío","type":"string"},"tracking_url":{"description":"URL pública de seguimiento","type":"string"}},"type":"object"}},"created_at":{"description":"Fecha y hora en que se creó el registro en Zipnova","type":"string","format":"date-time"},"updated_at":{"description":"Fecha y hora de la última actualización del registro","type":"string","format":"date-time"}},"type":"object"},"Address":{"title":"Dirección de orden","description":"Definición de una dirección utilizada en órdenes y envíos","properties":{"id":{"description":"Identificador","type":"integer"},"name":{"description":"Nombre","type":"string"},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Número","type":"string"},"street_extras":{"description":"Extras (piso, dpto, etc.)","type":"string"},"zipcode":{"description":"Código postal","type":"string"},"phone":{"description":"Teléfono","type":"string"},"email":{"description":"Correo electrónico","type":"string"},"document":{"description":"Documento/CUIT","type":"string"},"city":{"description":"Ciudad/Localidad/Comuna","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"description":"Provincia/Región/Estado","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"country":{"description":"País","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"location_latitude":{"description":"Latitud","type":"number"},"location_longitude":{"description":"Longitud","type":"number"},"location_type":{"description":"Tipo de ubicación","type":"string","nullable":true},"location_metadata":{"description":"Metadata de ubicación","type":"string","nullable":true},"is_accurate":{"description":"Indica si la geocodificación es precisa","type":"boolean","nullable":true},"created_at":{"description":"Fecha de creación","type":"string","format":"date-time"},"updated_at":{"description":"Fecha de última actualización","type":"string","format":"date-time"},"confirmed_at":{"description":"Fecha de confirmación de ubicación","type":"string","format":"date-time","nullable":true}},"type":"object"}}},"paths":{"/orders/{order}":{"get":{"tags":["Ventas"],"summary":"Obtener órden","description":"Retorna el detalle completo de un órden específico. El usuario autenticado debe tener acceso a la cuenta propietaria de la órden.","operationId":"a3341fc175ff13c2f80afe7c147b0449","parameters":[{"name":"order","in":"path","description":"ID de órden en Zipnova","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Detalle de la órden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderApiResource"}}}},"401":{"description":"No autenticado."},"403":{"description":"El usuario autenticado no tiene acceso a este órden."},"404":{"description":"Pedido no encontrado."}}}}}}
```

## Listar envíos de la órden

> Retorna un listado paginado de envíos asociados a un órden específico (50 por página). Requiere los permisos orders.view y shipments.show.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Ventas","description":"Gestión de ventas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"ShipmentApiResource":{"title":"Envío","properties":{"id":{"description":"ID único del envío","type":"integer"},"external_id":{"description":"Identificador externo del envío (e.g. número de orden del cliente)","type":"string","nullable":true},"delivery_id":{"description":"Número de remito asignado por el transportista","type":"string","nullable":true},"carrier_tracking_id":{"description":"Identificador de seguimiento público del transportista","type":"string","nullable":true},"carrier_tracking_id_alt":{"description":"Identificador de seguimiento alternativo del transportista","type":"string","nullable":true},"created_at":{"description":"Fecha y hora de creación del envío (ISO 8601)","type":"string","format":"date-time"},"delivery_time":{"description":"Tiempos estimados de entrega","properties":{"estimated_delivery":{"description":"Fecha estimada de entrega al destinatario (ISO 8601)","type":"string","format":"date-time","nullable":true},"dropoff_deadline_at":{"description":"Fecha límite para ingresar el envío al transportista (ISO 8601)","type":"string","format":"date-time","nullable":true},"times":{"description":"Desglose de tiempos en días hábiles. Indicados en formato ISO8601 para duraciones de tiempo.","properties":{"preparation":{"description":"Días de preparación antes de despacho","type":"string"},"crossdocking":{"description":"Días de tránsito por crossdocking","type":"string"},"carrier":{"description":"Días de tránsito del transportista","type":"string"},"total":{"description":"Tiempo total estimado en días hábiles","type":"string"}},"type":"object"}},"type":"object"},"account_id":{"description":"ID de la cuenta propietaria del envío","type":"integer"},"parent_shipment_id":{"description":"ID del envío padre. Presente cuando este envío es una devolución o reenvío","type":"integer","nullable":true},"logistic_type":{"description":"Tipo de logística del envío (e.g. crossdock, carrier_dropoff, xd_dropoff, self_service)","type":"string"},"service_type":{"description":"Código del tipo de servicio (e.g. standard, express, pickup_point)","type":"string"},"carrier":{"description":"Transportista asignado al envío","properties":{"id":{"description":"ID del transportista","type":"integer"},"name":{"description":"Nombre del transportista","type":"string"},"logo":{"description":"URL del logotipo del transportista","type":"string","nullable":true}},"type":"object"},"status":{"description":"Código de estado actual del envío (e.g. new, in_transit, delivered)","type":"string"},"status_name":{"description":"Nombre legible del estado actual","type":"string"},"tracking":{"description":"URL de seguimiento público del envío en la plataforma","type":"string","nullable":true},"tracking_external":{"description":"URL de seguimiento en el sitio web del transportista","type":"string","nullable":true},"return_instructions":{"description":"URL con instrucciones de devolución. Solo presente en envíos de tipo reverse logistics","type":"string","nullable":true},"destination":{"description":"Datos completos del destinatario","properties":{"name":{"description":"Nombre completo del destinatario","type":"string"},"document":{"description":"Documento de identidad del destinatario","type":"string"},"street":{"description":"Calle del destinatario","type":"string","nullable":true},"street_number":{"description":"Número de calle del destinatario","type":"string","nullable":true},"street_extras":{"description":"Piso, departamento u otras indicaciones adicionales","type":"string","nullable":true},"city":{"description":"Ciudad de destino","type":"string"},"state":{"description":"Provincia o estado de destino","type":"string"},"zipcode":{"description":"Código postal de destino","type":"string","nullable":true},"phone":{"description":"Teléfono de contacto del destinatario","type":"string"},"email":{"description":"Email de contacto del destinatario","type":"string","format":"email"},"pickup_point":{"description":"Datos del punto de retiro. Solo presente cuando service_type es pickup_point","properties":{"id":{"description":"ID del punto de retiro","type":"integer"},"name":{"description":"Nombre del punto de retiro","type":"string"},"geolocation":{"properties":{"lat":{"type":"number","format":"float"},"lng":{"type":"number","format":"float"}},"type":"object"}},"type":"object","nullable":true}},"type":"object"},"origin":{"description":"Datos completos del origen del envío","properties":{"id":{"description":"ID del origen en el catálogo de direcciones (address_book_id)","type":"integer"},"name":{"description":"Nombre del punto de origen","type":"string"},"document":{"description":"Documento de identidad del remitente","type":"string","nullable":true},"street":{"description":"Calle de origen","type":"string"},"street_number":{"description":"Número de calle de origen","type":"string"},"street_extras":{"description":"Información adicional de la dirección de origen","type":"string","nullable":true},"city":{"description":"Ciudad de origen","type":"string"},"state":{"description":"Provincia o estado de origen","type":"string"},"zipcode":{"description":"Código postal de origen","type":"string","nullable":true},"phone":{"description":"Teléfono de contacto del origen","type":"string"},"email":{"description":"Email de contacto del origen","type":"string","format":"email"},"is_dropshipping":{"description":"Indica si el envío parte desde un proveedor de dropshipping","type":"boolean"},"supplier":{"description":"Datos del proveedor dropshipping. Solo presente cuando is_dropshipping es true","properties":{"name":{"description":"Nombre del proveedor","type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"},"declared_value":{"description":"Valor declarado del contenido del envío en la moneda local","type":"number","format":"float"},"price":{"description":"Costo del envío sin impuestos","type":"number","format":"float"},"price_incl_tax":{"description":"Costo del envío con impuestos incluidos","type":"number","format":"float"},"total_weight":{"description":"Peso total del envío en gramos","type":"integer"},"total_volume":{"description":"Volumen total del envío en centímetros cúbicos (cm³)","type":"integer"},"packages":{"description":"Lista de paquetes del envío","type":"array","items":{"properties":{"id":{"description":"ID del paquete","type":"integer"},"label_code":{"description":"Código de etiqueta del paquete","type":"string","nullable":true},"sku_id":{"description":"ID del SKU si el paquete corresponde a un único SKU","type":"integer","nullable":true},"weight":{"description":"Peso del paquete en gramos","type":"integer"},"height":{"description":"Alto del paquete en milímetros","type":"integer"},"width":{"description":"Ancho del paquete en milímetros","type":"integer"},"length":{"description":"Largo del paquete en milímetros","type":"integer"},"volume":{"description":"Volumen del paquete en cm³","type":"integer"},"description_1":{"description":"Primera línea de descripción del contenido","type":"string"},"description_2":{"description":"Segunda línea de descripción del contenido","type":"string","nullable":true},"description_3":{"description":"Tercera línea de descripción del contenido","type":"string","nullable":true},"classification":{"description":"Clasificación arancelaria del contenido","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"tax_class_code":{"description":"Código de clase impositiva del paquete","type":"string","nullable":true},"container":{"description":"Caja o contenedor predefinido. Solo presente si el paquete usa un contenedor guardado","properties":{"id":{"type":"integer"},"description":{"type":"string"},"outer_width":{"description":"Ancho exterior en mm","type":"integer"},"outer_height":{"description":"Alto exterior en mm","type":"integer"},"outer_length":{"description":"Largo exterior en mm","type":"integer"},"inner_width":{"description":"Ancho interior en mm","type":"integer"},"inner_length":{"description":"Largo interior en mm","type":"integer"},"inner_height":{"description":"Alto interior en mm","type":"integer"},"max_weight":{"description":"Peso máximo soportado en gramos","type":"integer"},"empty_weight":{"description":"Peso vacío del contenedor en gramos","type":"integer"}},"type":"object","nullable":true},"items":{"description":"Ítems individuales dentro del paquete","type":"array","items":{"properties":{"id":{"type":"integer"},"sku":{"description":"Datos del SKU vinculado. Los campos internal_sku, name y barcode solo están presentes si el ítem tiene un SKU registrado","properties":{"sku":{"description":"Código SKU","type":"string","nullable":true},"sku_id":{"description":"ID del SKU","type":"integer","nullable":true},"internal_sku":{"description":"SKU interno","type":"string","nullable":true},"name":{"description":"Nombre del producto","type":"string","nullable":true},"barcode":{"description":"Código de barras","type":"string","nullable":true}},"type":"object"},"description":{"description":"Descripción del ítem","type":"string"},"tax_class_code":{"description":"Código de clase impositiva del ítem","type":"string","nullable":true},"must_keep_vertical":{"description":"Indica si el ítem debe mantenerse vertical durante el transporte","type":"boolean"},"weight":{"description":"Peso en gramos","type":"integer"},"width":{"description":"Ancho en mm","type":"integer"},"length":{"description":"Largo en mm","type":"integer"},"height":{"description":"Alto en mm","type":"integer"},"pos_x":{"description":"Posición X dentro del contenedor (mm)","type":"integer","nullable":true},"pos_y":{"description":"Posición Y dentro del contenedor (mm)","type":"integer","nullable":true},"pos_z":{"description":"Posición Z dentro del contenedor (mm)","type":"integer","nullable":true}},"type":"object"}}},"type":"object"}},"tags":{"description":"Etiquetas asociadas al envío","type":"array","items":{"type":"string"}},"related_shipments":{"description":"Envíos relacionados (padre, devoluciones, reenvíos)","type":"array","items":{"properties":{"type":{"description":"Rol del envío relacionado","type":"string","enum":["parent","child"]},"relationship":{"description":"Tipo de relación entre los envíos","type":"string","enum":["copy","return","reshipped"]},"shipment_id":{"description":"ID del envío relacionado","type":"integer"}},"type":"object"}},"source":{"description":"Fuente u origen de creación del envío (e.g. nombre del canal o integración)","type":"string","nullable":true},"marketplace":{"description":"Marketplace asociado al envío. Presente solo si el envío proviene de un marketplace","properties":{"code":{"description":"Código del marketplace","type":"string"},"name":{"description":"Nombre del marketplace","type":"string"}},"type":"object","nullable":true},"order":{"description":"Pedido del canal de venta asociado al envío. Presente solo si el envío tiene un orden vinculado","properties":{"id":{"description":"ID interno del pedido","type":"integer"},"channel":{"description":"Canal de venta (e.g. meli, tiendanube, shopify, vtex)","type":"string"},"channel_created_at":{"description":"Fecha de creación del pedido en el canal (ISO 8601)","type":"string","format":"date-time"},"channel_relations":{"description":"IDs del pedido en el canal de venta (orden, paquete, envío del canal)","type":"array","items":{"properties":{"type":{"type":"string","enum":["order","pack","shipment"]},"id":{"description":"ID del recurso en el canal"}},"type":"object"},"nullable":true}},"type":"object","nullable":true},"fulfillment_order":{"description":"Orden de fulfillment asociada al envío. Presente solo si el envío está vinculado a un proceso de fulfillment","properties":{"id":{"type":"integer"},"status_id":{"description":"ID del estado de la orden de fulfillment","type":"integer"},"external_id":{"description":"ID externo de la orden de fulfillment","type":"string","nullable":true},"items":{"type":"array","items":{"properties":{"sku_id":{"type":"integer"},"qty":{"description":"Cantidad de unidades","type":"integer"},"lot_numbers":{"description":"Números de lote","type":"array","items":{"type":"string"},"nullable":true},"serial_numbers":{"description":"Números de serie","type":"array","items":{"type":"string"},"nullable":true}},"type":"object"}}},"type":"object","nullable":true}},"type":"object"}}},"paths":{"/orders/{order}/shipments":{"get":{"tags":["Ventas"],"summary":"Listar envíos de la órden","description":"Retorna un listado paginado de envíos asociados a un órden específico (50 por página). Requiere los permisos orders.view y shipments.show.","operationId":"7413fabcc93c8c4db4b645f5d46aa272","parameters":[{"name":"order","in":"path","description":"ID de la órden en Zipnova","required":true,"schema":{"type":"integer"}},{"name":"page","in":"query","description":"Número de página para la paginación (50 envíos por página).","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Listado paginado de envíos de la órden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentApiResource"}}}},"401":{"description":"No autenticado."},"403":{"description":"El usuario autenticado no tiene acceso a este órden o le falta el permiso shipments.show."},"404":{"description":"Pedido no encontrado."}}}}}}
```