Crear

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

Los atributos carrier_id, service_type, logistic_type y destination.point_id (si es envio a sucursal) deben haber sido obtenidos previamente de una cotización.

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 Para indicar con qué transporte crear el envío (sale de la cotización).
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
phone string Teléfono del destinatario
email string E-mail del destinatario
point_id string ID del punto de entrega seleccionado (sale de la cotización) Obligatorio para servicio pickup_point, caso contrario omitir.
street string Calle de destino (no incluir nro de puerta) Máx. 50 caracteres. Obligatorio salvo para servicio pickup_point
street_number string Nro. de puerta del domicilio Máx. 10 caracteres. Obligatorio salvo para servicio pickup_point
street_extras string Piso, Depto, aclaraciones Opcional (nullable)
Max. 150 caracteres
city string Ciudad/Localidad Ej. San Miguel de Tucuman. Obligatorio salvo para servicio pickup_point
state string Provincia Ej. Tucuman. Obligatorio salvo para servicio pickup_point
zipcode int Código postal Ej. 4500. Obligatorio salvo para servicio pickup_point

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 201
{
    "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 201
{
  "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": []
}