Crear

El endpoint de creación nos permite crear el envío, indicando todo el detalle del mismo y sus paquetes.

Es posible indicar con qué transporte crear el envío, para lo cual se deberá indicar el carrier_id obtenido en una cotización.

En caso de no indicar el transporte, la selección del mismo se basará en la preferencia de método de selección dentro de la configuración de la cuenta, la cual puede basarse en precio, nivel de servicio o tiempo de entrega.

POST /shipments
Parámetros para el body:
account_id int ID de la cuenta
declared_value decimal Valor declarado del envío Ej: 200.50
service_type string Código del tipo de servicio Ej. standard_delivery
origin_id int ID del origen del envío
carrier_id int Opcional. Para indicar con qué transporte crear el envío.
Si no se indica, se seleccionará un transporte automáticamente.
source string Opcional. Usado en integraciones específicas.
packages array de Packages (objetos)
weight int Peso en gramos
height
length
width
int Medidas del paquete, en centímetros
classification_id int 1 General
2 Colchones
sku_id int Opcional. Para utilizar un SKU del catálogo. Si se usa, no es necesario indicar ninguno de los otros atributos del paquete.
destination object
name string Nombre y apellido del destinatario
document string Documento del destinatario
street string Calle de destino (no incluir nro de puerta) Máx. 50 caracteres
street_number string Nro. de puerta del domicilio Máx. 10 caracteres
street_extras string Piso, Depto, aclaraciones Opcional (nullable)
Max. 150 caracteres
city string Ciudad/Localidad Ej. San Miguel de Tucuman
state string Provincia Ej. Tucuman
zipcode int Código postal Ej. 4500
phone string Teléfono del destinatario
email string E-mail del destinatario

Ejemplo:

POST https://api.zippin.com.ar/v2/shipments

{
    "external_id": "teste210119",
    "account_id": 2,
    "service_type": "standard_delivery",
    "carrier_id": 13,
    "destination": {
        "name": "eee",
        "document": "9999",
        "street": "999",
        "street_number": "99",
        "street_extras": null,
        "city": "Capital Federal",
        "state": "Capital Federal",
        "zipcode": "1425",
        "phone": "99999999",
        "email": "dsdsd@fddm.com"
    },
    "origin_id": 25,
    "declared_value": 1425,
    "packages": [
        {
            "sku_id": null,
            "weight": 10000,
            "height": 20,
            "width": 20,
            "length": 20,
            "description_1": "test",
            "description_2": null,
            "description_3": null,
            "classification_id": 1
        }
    ]
}



RESPONSE 200
{
    "id": 103171,
    "external_id": "teste210119",
    "delivery_id": null,
    "created_at": "2019-02-13T19:30:47+0000",
    "account_id": 2,
    "parent_shipment_id": null,
    "service_type": "standard_delivery",
    "carrier": {
        "id": 13,
        "name": "Logicargo",
        "logo": "https://zippin-ar.s3.amazonaws.com/carriers/logicargo/nI5FGjiEtlavVu7HDFJKKFqXq7MWGiSyOB6M1gA8.png"
    },
    "status": "new",
    "status_name": "Nuevo",
    "tracking": "http://zippin.local/tracking/103171/2",
    "tracking_external": "http://zippin.local/tracking/teste210119/2/external_id",
    "destination": {
        "name": "eee",
        "document": "9999",
        "street": "999",
        "street_number": "99",
        "street_extras": null,
        "city": "Capital Federal",
        "state": "Capital Federal",
        "zipcode": "1425",
        "phone": "99999999",
        "email": "dsdsd@fddm.com"
    },
    "origin": {
        "id": 25,
        "name": "Origen Demo",
        "document": "22222222",
        "street": "Falsa",
        "street_number": "123",
        "street_extras": null,
        "city": "Capital Federal",
        "state": "Capital Federal",
        "zipcode": "1005",
        "phone": "22222222",
        "email": "demo@zippin.com.ar"
    },
    "declared_value": 1425,
    "price": 103.31,
    "price_incl_tax": 125,
    "total_weight": 10000,
    "total_volume": 8000,
    "packages": [
        {
            "internal_id": 68885,
            "sku_id": null,
            "weight": 10000,
            "height": 20,
            "width": 20,
            "length": 20,
            "volume": 8000,
            "description_1": "test",
            "description_2": null,
            "description_3": null,
            "classification": {
                "id": 1,
                "name": "General"
            }
        }
    ]
}