Creación de entregas

En esta sección aprenderás a crear tu primera entrega dendro de Shippify

Con este endpoint podrás crear hasta un máximo de 100 entregas por request y 100 request por minuto.

Creación de entregas

post

Crea hasta 100 entregas dentro de Shippify

Autorizaciones
Cuerpo
companyIdinteger · mín: 1Opcional

Identificador de la compañia donde se va a crear la entrega

Example: 2
typestring · enumOpcional

Tipo de entrega

Default: slotValores posibles:
Respuestas
200
Successful operation
application/json
post
POST /v1/deliveries HTTP/1.1
Host: api.shippify.co
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 775

{
  "companyId": 2,
  "type": "slot",
  "deliveries": [
    {
      "pickup": {
        "contact": {
          "name": "Iliana Bolaños",
          "email": "[email protected]",
          "phonenumber": "0998976565"
        },
        "location": {
          "address": "Vicuna Mackenna 6100, La Florida, Region Metropolitana, Chile",
          "instructions": "Local 1001",
          "lat": -33.511333999,
          "lng": -70.6102933
        }
      },
      "dropoff": {
        "contact": {
          "name": "Iliana Bolaños",
          "email": "[email protected]",
          "phonenumber": "0998976565"
        },
        "location": {
          "address": "Vicuna Mackenna 6100, La Florida, Region Metropolitana, Chile",
          "instructions": "Local 1001",
          "lat": -33.511333999,
          "lng": -70.6102933
        }
      },
      "packages": [
        {
          "id": "Product-001",
          "name": "Caja de colores",
          "qty": 4,
          "weight": 5.3,
          "size": "xs",
          "price": 15.2
        }
      ],
      "referenceId": "PO-00012",
      "tags": [
        "Delicado"
      ],
      "extraData": [
        {
          "name": "Factura",
          "value": "FA-000001"
        }
      ],
      "cod": 22.3
    }
  ]
}
{
  "code": "OK",
  "message": "Delivery created successfully",
  "payload": [
    {
      "index": 0,
      "id": "t-shiinc-27946",
      "price": 10.4,
      "currencyCode": "CLP",
      "distance": 10.4,
      "cityId": 2,
      "destinationCityId": 2,
      "insurance": 2.3,
      "statusDelivery": "processing",
      "vehicleCapacity": 2,
      "deliveryDate": "2023-10-27 19:09:11",
      "trackLink": "https://api.shippify.co/track/t-pruaas-4973?token=XXXXXXXXXXXXX",
      "referenceId": "PO-00012"
    }
  ]
}

Casos de uso

Creación de entrega con reference id

Este es el payload mas básico con el que puedes usar el API, sin embargo es probable que la tarea se cree con estado pendiente de revisión si la dirección no se puede geolocalizar.

{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "phonenumber": "0976565643",
                    "email": "[email protected]",
                    "name": "Iliana Bolaños"
                },
                "location": {
                    "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
                    "instructions": "Apartamento 203"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "Estefanía Fajardo",
                    "email": "[email protected]"
                },
                "location": {
                    "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
                    "instructions": "Local 890"
                }
            },
            "packages": [
                {
                    "name": "Caja de colores",
                    "qty": 1,
                    "size": 1
                }
            ],
            "referenceId": "FACT-000123"
        }
    ]
}

Creación de entrega con dirección con lat y long

Con este payload podrás crear entregas con un punto de recolección y entrega preciso, de esta manera la tarea siempre se creará con estado procesando. 

{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "name": "Emilio Benavides",
                    "phonenumber": "12345"
                },
                "location": {
                    "address": "Av. Echeñique 8861, 7860169 La Reina, Región Metropolitana, Chile",
                    "lat": "-33.44299381045172",
                    "lng": "-70.53898694556675"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "MAYGER RENE MONTERO SAAVEDRA",
                    "email": "[email protected]",
                    "phonenumber": "777"
                },
                "location": {
                    "address": "Los Castaños 11989, 8010277 Santiago, El Bosque, Región Metropolitana, Chile",
                    "lat": "-33.56751",
                    "lng": "-70.67549"
                }
            },
            "packages": [
                {
                    "name": "149123156552",
                    "size": "XS",
                    "qty": "1"
                }
            ]
        }
    ]
}
Creación de entrega con dirección por componentes

Con este payload podrás crear entregas con un punto de recolección o entrega un poco más preciso y con menos probabilidades que se cree como pendiente de revisión. Consiste en separar la dirección en pais, ciudad, calle, zip code.

{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "name": "Emilio Benavides",
                    "phonenumber": "12345"
                },
                "location": {
                    "address": "R. Dona Claudina, 401 - Méier, Rio de Janeiro - RJ, 20725-060, Brasil",
                    "lat": -22.906846699999996,
                    "lng": -43.28275978125001
                }
            },
            "dropoff": {
                "contact": {
                    "name": "MAYGER RENE MONTERO SAAVEDRA",
                    "email": "[email protected]",
                    "phonenumber": "777"
                },
                "location": {
                    "address": {
                        "zipcode": "60348450",
                        "neighborhood": "VILA VELHA",
                        "streetName": "RUA 24,656",
                        "state": "CE",
                        "country": "Brazil",
                        "city": "FORTALEZA"
                    },
                    "instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA"
                }
            },
            "packages": [
                {
                    "name": "149123156552",
                    "size": "XS",
                    "qty": "1"
                }
            ]
        }
    ]
}
Creación de entrega desde o hasta una bodega configurada

Con este payload podrás crear entregas con un punto de recolección guardado previamente en la sección de bodegas.

{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "name": "Emilio Benavides",
                    "phonenumber": "12345"
                },
                "location": {
                    "warehouse": 9
                }
            },
            "dropoff": {
                "contact": {
                    "name": "MAYGER RENE MONTERO SAAVEDRA",
                    "email": "[email protected]",
                    "phonenumber": "777"
                },
                "location": {
                    "address": {
                        "zipcode": "60348450",
                        "neighborhood": "VILA VELHA",
                        "streetName": "RUA 24,656",
                        "state": "CE",
                        "country": "Brazil",
                        "city": "FORTALEZA"
                    },
                    "instructions": "CONJ DOS BANCARIOS - REF.ENDERECO: PROX A UPA"
                }
            },
            "packages": [
                {
                    "name": "149123156552",
                    "size": "XS",
                    "qty": "1"
                }
            ]
        }
    ]
}
Creación de entrega con tags y extradata

Con las etiquetas digitales podrás agregar caracteristicas adicionales a la tarea para posteriormente poder filtrar por ellas por ejemplo: frágil.

Con la extradata podrás enlazar información adicional a la entrega.

{
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "phonenumber": "0976565643",
                    "email": "[email protected]",
                    "name": "Iliana Bolaños"
                },
                "location": {
                    "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
                    "instructions": "Apartamento 203"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "Estefanía Fajardo",
                    "email": "[email protected]"
                },
                "location": {
                    "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
                    "instructions": "Local 890"
                }
            },
            "packages": [
                {
                    "name": "Caja de colores",
                    "qty": 1,
                    "size": 1
                }
            ],
            "tags" : [ 
                "fragil"
            ],
             "extraData": [
                {
                    "name": "GUIA DE REMISION",
                    "value": "0001-000344-2233",
                    "searchable": true
                }
            ],
            "referenceId": "FACT-000123"
        }
    ]
}
Creación de entrega para una compañia hija

Con este payload podrás crear entregas a una compañia hija con la autorización de la compañía padre.

{
    
    "deliveries": [
        {
            "pickup": {
                "contact": {
                    "phonenumber": "0976565643",
                    "email": "[email protected]",
                    "name": "Iliana Bolaños"
                },
                "location": {
                    "address": "Av. Francisco de Orellana 8, Guayaquil 090502, Ecuador",
                    "instructions": "Apartamento 203"
                }
            },
            "dropoff": {
                "contact": {
                    "name": "Estefanía Fajardo",
                    "email": "[email protected]"
                },
                "location": {
                    "address": "Malecón 2000, Simon Bolivar Palacios, Guayaquil 090313, Ecuador",
                    "instructions": "Local 890"
                }
            },
            "packages": [
                {
                    "name": "Caja de colores",
                    "qty": 1,
                    "size": 1
                }
            ],
            "referenceId": "FACT-000123"
        }
    ]
}
AnteriorEntregasSiguienteCotización de entregas

Última actualización