Crear

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

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.

El Request

Para hacer el request hay dos variantes, una basada en paquetes, y otra basada en items.

Crear en base a paquetes

En esta variante se debe enviar un array packages con cada paquete que compondrá el envio. Un paquete es un bulto que tendrá su propia etiqueta. Un envío puede estar compuesto de uno o más bultos. A su vez, cada bulto puede tener adentro multiples items, pero para este modo de cotizacion es irrelevante.

Crear en base a items

En esta variante se debe enviar un array items con cada item que compondrá el envio. Un item es una unidad de un producto, que se podrá agrupar con otros items en una o mas cajas o paquetes. Luego, cada paquete resultante tendrá su propia etiqueta. En Zippin es posible configurar las cajas que usa el vendedor para preparar sus envios, las cuales se usaran para determinar automáticamente cómo agrupar los items en paquetes.

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 (sale de la cotización) Ej. standard_delivery
logistic_type string Código del modo de despacho (sale de la cotización) Ej. crossdock
origin_id int ID del origen del envío
carrier_id int Opcional. Para indicar con qué transporte crear el envío (sale de la cotización).
Si no se indica, se seleccionará un transporte automáticamente.
source string Opcional. Usado en integraciones específicas.
packages array de Packages (objetos) - no usar junto con items
weight int Peso en gramos
height
length
width
int Medidas del paquete, en centímetros
classification_id int 1 General
2 Colchones
sku string Opcional. Para utilizar un SKU del catálogo. Si se usa, no es necesario indicar ninguno de los otros atributos del paquete.
items array de Items (objetos) - no se debe enviar si se usa packages
sku string SKU del item Se intentará vincular a un SKU cargado en el catalogo de Zippin.
weight int Peso en gramos
height
length
width
int Medidas del item, en centímetros
classification_id int 1 General
2 Colchones

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 usando la variante de packages:

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

{
    "external_id": "teste210119",
    "account_id": 2,
    "service_type": "standard_delivery",
    "logistic_type": "crossdock",
    "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",
    "logistic_type": "crossdock",
    "carrier": {
        "id": 13,
        "name": "Logicargo",
        "logo": "https://zippin-ar.s3.amazonaws.com/carriers/logicargo/nI5FGjiEtlavVu7HDFJKKFqXq7MWGiSyOB6M1gA8.png"
    },
    "status": "new",
    "status_name": "Procesando",
    "tracking": "https://app.zippin.com.ar/tracking/103171/2",
    "tracking_external": "https://app.zippin.com.ar/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"
            }
        }
    ]
}

Ejemplo usando la variante de items:

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

{
	"external_id": "testcosts",
	"account_id": "2",
	"origin_id": "25",
	"service_type": "standard_delivery",
    "logistic_type": "crossdock",
	"carrier_id": 8,
	"declared_value": 9015,
	"items": [
		{
			"weight": 500,
			"height": 8,
			"width": 8,
			"length": 8,
			"sku": "iphone"
		},
		{
			"weight": 500,
			"height": 8,
			"width": 8,
			"length": 8,
			"sku": "iphone"
		}
	],
	"destination": {
		"zipcode": "4400",
		"state": "Salta",
		"city": "salta",
		"name": "TEST",
		"document": "3333",
		"street": "TEST",
		"street_number": "222",
		"street_extras": "TEST",
		"phone": "00000",
		"email": "TEST@test.com"

	}
}


RESPONSE 200
{
  "id": 151060,
  "external_id": "testcosts",
  "delivery_id": "0999-00151060",
  "carrier_tracking_id": null,
  "created_at": "2020-06-09T15:19:07+0000",
  "account_id": 2,
  "parent_shipment_id": null,
  "logistic_type": "crossdock",
  "service_type": "standard_delivery",
  "carrier": {
    "id": 8,
    "name": "La Sevillanita",
    "logo": "https:\/\/zippin-ar.s3.amazonaws.com\/carriers\/la-sevillanita\/Kt4qo3TsENegNCCnrW70OxQhBqbo7uyfemNRT5bH.png"
  },
  "status": "new",
  "status_name": "Procesando",
  "tracking": "http:\/\/app.zippin.com.ar\/track\/151060",
  "tracking_external": "http:\/\/app.zippin.com.ar\/track\/2\/testcosts",
  "destination": {
    "name": "TEST",
    "document": "3333",
    "street": "TEST",
    "street_number": "222",
    "street_extras": "TEST",
    "city": "Salta",
    "state": "Salta",
    "zipcode": "4400",
    "phone": "00000",
    "email": "TEST@test.com"
  },
  "origin": {
    "id": 25,
    "name": "Origen Demo",
    "document": "22222222",
    "street": "Av Luis Maria Campos",
    "street_number": "877",
    "street_extras": "PRUEBA",
    "city": "Capital Federal",
    "state": "Capital Federal",
    "zipcode": "1005",
    "phone": "22222222",
    "email": "demo@zippin.com.ar"
  },
  "declared_value": 9015,
  "price": 869.42,
  "price_incl_tax": 1052,
  "total_weight": 1100,
  "total_volume": 4080,
  "packages": [
    {
      "internal_id": 148121,
      "sku_id": null,
      "weight": 1100,
      "height": 12,
      "width": 20,
      "length": 17,
      "volume": 4080,
      "description_1": "2 productos",
      "description_2": "Test 1",
      "description_3": null,
      "classification": {
        "id": 1,
        "name": "General"
      },
      "items": [
        {
          "sku": null,
          "description": "iphone",
          "must_keep_vertical": 0,
          "weight": 500,
          "width": 8,
          "length": 8,
          "height": 8,
          "pos_x": 0,
          "pos_y": 0,
          "pos_z": 0
        },
        {
          "sku": null,
          "description": "iphone",
          "must_keep_vertical": 0,
          "weight": 500,
          "width": 8,
          "length": 8,
          "height": 8,
          "pos_x": 8,
          "pos_y": 0,
          "pos_z": 0
        }
      ],
      "container": {
        "id": 1,
        "description": "Test 1",
        "outer_width": 20,
        "outer_height": 12,
        "outer_length": 17,
        "inner_width": 19,
        "inner_length": 16,
        "inner_height": 11,
        "max_weight": 5000
      }
    }
  ],
  "tags": []
}