# Crear Envíos
{% hint style="warning" %}
Los endpoints de creación de envíos utilizan **rate limiting** :red\_circle:**Alto**\
[Ver más sobre límites de requests](/envios/principios/limites-de-requests.md)
{% endhint %}
{% hint style="warning" %}
Al crear un envío necesitarás informar algunos datos que surgen de la [cotización](/envios/recursos-api/envios/cotizar-envios.md).
**Luego de cotizar, debes almacenar los valores de `logistic_type`, `service_type`, `carrier_id` de la opción de envío deseada, para luego utilizarlos al crear el envío.**
Si se trata de un envío a retirar por sucursal, también debes almacenar el `point_id` de la ubicación donde se vaya a hacer el retiro del envío por el destinatario.
{% endhint %}
{% hint style="info" %}
Recomendamos completar el atributo `source` con algo que identifique a tu integración, para que luego los clientes puedan definir reglas personalizadas de cotización utilizando el [Motor de Reglas](https://ayuda.zippin.app/automatizaciones), utilizando el atributo source como criterio de filtrado.
{% endhint %}
## Crear envío
> Crea un nuevo envío. Se deben proveer el origen, el destino, el tipo de servicio y los paquetes o ítems. El sistema cotiza automáticamente y asigna el transportista más adecuado salvo que se indique uno específico. Se debe proveer packages o items, no ambos.
```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Envíos","description":"Gestión de envíos y tracking"}],"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},"label_elements":{"description":"Elementos para renderizar en la etiqueta del paquete (códigos de barra, QR, etc.). El contenido varía según el transportista. Presente solo cuando el envío tiene etiqueta generada.","type":"array","items":{"properties":{"id":{"description":"Identificador del elemento (e.g. zipnova_label_code, carrier_tracking_code, carrier_extra_code)","type":"string"},"type":{"description":"Tipo de elemento gráfico","type":"string","enum":["barcode","qrcode"]},"format":{"description":"Formato del código de barras. Solo presente cuando type es barcode","type":"string","nullable":true},"value":{"description":"Valor a codificar en el elemento gráfico","type":"string"}},"type":"object"},"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":{"/shipments":{"post":{"tags":["Envíos"],"summary":"Crear envío","description":"Crea un nuevo envío. Se deben proveer el origen, el destino, el tipo de servicio y los paquetes o ítems. El sistema cotiza automáticamente y asigna el transportista más adecuado salvo que se indique uno específico. Se debe proveer packages o items, no ambos.","operationId":"35d6df0d7031348b1ac8c9575a922227","requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["account_id","service_type","external_id","origin_id","declared_value","destination"],"properties":{"account_id":{"description":"ID de la cuenta bajo la cual se crea el envío","type":"integer"},"external_id":{"description":"Identificador único del envío en el sistema del cliente (alfanumérico y guiones, máx. 30 caracteres)","type":"string"},"service_type":{"description":"Código del tipo de servicio (e.g. standard, express, pickup_point)","type":"string"},"logistic_type":{"description":"Tipo de logística. Si se omite el sistema lo selecciona automáticamente (e.g. crossdock, carrier_dropoff, xd_dropoff)","type":"string"},"carrier_id":{"description":"ID del transportista a usar. Si se omite el sistema elige automáticamente según sort_by","type":"integer","nullable":true},"sort_by":{"description":"Criterio de selección automática del transportista cuando no se especifica carrier_id","type":"string","enum":["price","rating","time"],"nullable":true},"origin_id":{"description":"ID del origen en el catálogo de direcciones (address_book_id). Usar \"auto\" para selección automática de depósito","type":"string"},"declared_value":{"description":"Valor declarado del contenido del envío en la moneda local","type":"number","format":"float"},"source":{"description":"Identificador de la fuente o integración que origina el envío (máx. 150 caracteres)","type":"string","nullable":true},"type_packaging":{"description":"Estrategia de empaquetado de ítems. Solo aplica cuando se usa el campo items","type":"string","enum":["dynamic","boxes","none"],"nullable":true},"process_immediately":{"description":"Si es 1, el envío se procesa y despacha inmediatamente luego de crearlo","type":"integer","enum":[0,1]},"destination":{"description":"Datos del destinatario. Para service_type pickup_point usar point_id en lugar de street/city/state","required":["name","document","email","phone"],"properties":{"name":{"description":"Nombre completo del destinatario","type":"string"},"document":{"description":"Documento de identidad del destinatario","type":"string"},"email":{"description":"Email del destinatario","type":"string","format":"email"},"phone":{"description":"Teléfono del destinatario","type":"string"},"street":{"description":"Calle. Requerido salvo para pickup_point","type":"string"},"street_number":{"description":"Número de calle. Requerido salvo para pickup_point","type":"string"},"street_extras":{"description":"Piso, departamento u otras indicaciones adicionales","type":"string","nullable":true},"city":{"description":"Ciudad. Requerido junto con state salvo para pickup_point o cuando se usa id","type":"string"},"state":{"description":"Provincia o estado. Requerido junto con city","type":"string"},"zipcode":{"description":"Código postal. Requerido según configuración del país","type":"string","nullable":true},"id":{"description":"ID de ciudad en el catálogo interno. Alternativa a city+state","type":"integer","nullable":true},"point_id":{"description":"ID del punto de retiro (carrier_locations.id). Requerido cuando service_type es pickup_point","type":"integer","nullable":true}},"type":"object"},"packages":{"description":"Paquetes del envío con dimensiones declaradas. Requerido si no se usa items. Enviar packages O items, no ambos","type":"array","items":{"properties":{"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"},"description_1":{"description":"Descripción del contenido (requerido salvo que se use sku o sku_id)","type":"string"},"description_2":{"description":"Segunda línea de descripción","type":"string","nullable":true},"description_3":{"description":"Tercera línea de descripción","type":"string","nullable":true},"classification_id":{"description":"ID o código de clasificación arancelaria del contenido (e.g. 1 o \"general\")"},"tax_class_code":{"description":"Código de clase impositiva","type":"string","nullable":true},"sku_id":{"description":"ID del SKU para autocompletar dimensiones desde el catálogo","type":"integer","nullable":true},"sku":{"description":"Código SKU para autocompletar dimensiones desde el catálogo","type":"string","nullable":true},"container_id":{"description":"ID de caja predefinida del catálogo de contenedores","type":"integer","nullable":true},"items":{"description":"Ítems dentro del paquete. Requerido cuando se usa container_id","type":"array","items":{"properties":{"weight":{"description":"Peso en gramos","type":"integer"},"height":{"description":"Alto en mm","type":"integer"},"width":{"description":"Ancho en mm","type":"integer"},"length":{"description":"Largo en mm","type":"integer"},"sku":{"description":"Código SKU para autocompletar dimensiones","type":"string","nullable":true},"must_keep_vertical":{"description":"Si el ítem debe mantenerse vertical","type":"boolean"},"description":{"description":"Descripción del ítem","type":"string","nullable":true}},"type":"object"},"nullable":true}},"type":"object"}},"items":{"description":"Ítems individuales sin empaquetar. El sistema los empaqueta automáticamente según type_packaging. Requerido si no se usa packages","type":"array","items":{"properties":{"weight":{"description":"Peso en gramos. Requerido si no se usa sku","type":"integer"},"height":{"description":"Alto en mm. Requerido si no se usa sku","type":"integer"},"width":{"description":"Ancho en mm. Requerido si no se usa sku","type":"integer"},"length":{"description":"Largo en mm. Requerido si no se usa sku","type":"integer"},"sku":{"description":"Código SKU o reference_code del producto para autocompletar dimensiones","type":"string","nullable":true},"description":{"description":"Descripción del ítem","type":"string","nullable":true},"must_keep_vertical":{"description":"Si el ítem debe mantenerse vertical durante el transporte","type":"boolean"},"classification_id":{"description":"ID o código de clasificación arancelaria","nullable":true},"tax_class_code":{"description":"Código de clase impositiva","type":"string","nullable":true}},"type":"object"}}},"type":"object"}}}},"responses":{"201":{"description":"Envío creado exitosamente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentApiResource"}}}},"400":{"description":"Datos inválidos, ubicación no reconocida o no se pudo cotizar el envío"},"403":{"description":"Sin permiso para crear envíos en esta cuenta"},"422":{"description":"Error de validación de los datos enviados"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.zipnova.com/envios/recursos-api/envios/crear-envios.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.