# Modificar entrega

Endpoint para actualizar datos de la entrega, esto incluye la dirección y la información de contacto del punto de entrega, asi como tambien el propiedades como paquetes, etiquetas, paquetes, cod, identificador de referencia, entre otros.

## Editar datos de entrega

> Endpoint que permite editar los datos de una o múltiples entregas.

```json
{"openapi":"3.0.0","info":{"title":"API de Shippify","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Servidor de desarrollo"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"editDropoff":{"successfulResponse":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","description":"Información de procesos adicionales creados (si la entrega pertenece a una ruta)","properties":{"jobs":{"description":"Identificador del proceso externo creado","type":"string"}}}}},"request":{"type":"object","required":["deliveryIds","deliveryChanges"],"properties":{"deliveryIds":{"description":"Lista de identificadores de entrega a editar, hasta 10 entregas pueden ser editadas en una sola solicitud","type":"array","items":{"type":"string"}},"referenceIds":{"description":"Lista de identificadores de referencia de órdenes a editar, hasta 10 entregas pueden ser editadas en una sola solicitud. Si se usa esta propiedad, no incluir deliveryIds ","type":"array","items":{"type":"string"}},"deliveryChanges":{"description":"Cambios a realizar en la tarea","type":"object","properties":{"location":{"$ref":"#/components/schemas/delivery/location"},"contact":{"$ref":"#/components/schemas/delivery/contact"},"packages":{"description":"Información de paquetes.","type":"array","items":{"$ref":"#/components/schemas/delivery/package"}},"cod":{"description":"Pago contra entrega","type":"number","minimum":0},"referenceId":{"description":"Identificador externo de la entrega, puede ser el número de orden","type":"string","maxLength":40},"addTags":{"description":"IDs de etiquetas digitales a agregar a la entrega","type":"array","items":{"type":"integer","minimum":1}},"removeTags":{"description":"IDs de etiquetas digitales a remover de la entrega","type":"array","items":{"type":"integer","minimum":1}}}},"recalculatePrice":{"description":"Indica si recalcular el precio después de la modificación (recomendado)","type":"boolean"},"reorderRoute":{"description":"Indica si reordenar la ruta (si la entrega pertenece a una ruta) después de la modificación (recomendado)","type":"boolean"},"recalculateCity":{"description":"Indica si recalcular la ciudad después de la modificación (recomendado)","type":"boolean"}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"},"delivery":{"location":{"description":"Información de dirección de la ubicación de recolección de los paquetes de entrega.","type":"object","required":["address"],"properties":{"address":{"description":"Dirección de entrega.","type":"string"},"instructions":{"description":"Información extra sobre la dirección.","type":"string"},"lat":{"description":"Latitud del punto de recolección.","type":"string"},"lng":{"description":"Longitud del punto de recolección.","type":"string"}}},"contact":{"description":"Información de contacto de la persona responsable de entregar los paquetes en el almacén de recolección.","type":"object","required":["name","email"],"properties":{"name":{"description":"Nombre de la persona responsable.","type":"string"},"email":{"description":"Email de la persona responsable.","type":"string","format":"email"},"phonenumber":{"description":"Número de teléfono de la persona responsable.","type":"string"}}},"package":{"type":"object","required":["name","qty","size"],"properties":{"id":{"type":"string","description":"Identificador del paquete"},"name":{"type":"string","description":"Nombre del paquete"},"qty":{"description":"Número de paquetes en la orden (no el número de productos dentro del paquete).","type":"integer","minimum":0},"weight":{"description":"Peso unitario * cantidad en Kg","type":"number","minimum":0},"size":{"description":"Package size","type":"string","enum":["xs","s","m","l","xl"]},"price":{"description":"Precio unitario * cantidad en la moneda de la empresa","type":"number","minimum":0}}}}}},"paths":{"/v1/deliveries/dropoff":{"patch":{"tags":["Editar entrega"],"summary":"Editar datos de entrega","description":"Endpoint que permite editar los datos de una o múltiples entregas.","responses":{"200":{"description":"Operación exitosa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/editDropoff/successfulResponse"}}}},"401":{"description":"No autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"requestBody":{"description":"Aquí va la descripción","content":{"application/json":{"schema":{"$ref":"#/components/schemas/editDropoff/request"}}}}}}}}
```

## Casos de uso

<details>

<summary>Modificar entrega por deliveryId</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "reorderRoute": true,
    "recalculatePrice": true,
    "recalculateCity": false,
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUCTOS EN POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        },
        "contact": {
            "name": "Juan Perez",
            "email": "example@shippify.co"
        },
        "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ],
        "cod": 10,
        "referenceId": "0987837468",
        "addTags":[1003],
        "removeTags": [],
        "extraData": [{"name":"Billing", "value":"0000-123-334"}]
    }
}
```

</details>

<details>

<summary>Modificar entrega por referenceId</summary>

```json
{
    "referenceIds": [
        "0987837468"
    ],
    "reorderRoute": true,
    "recalculatePrice": true,
    "recalculateCity": false,
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUCTOS EN POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        },
        "contact": {
            "name": "Juan Perez",
            "email": "example@shippify.co"
        },
        "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ],
        "cod": 10,
        "referenceId": "0987837468",
        "addTags":[1003],
        "removeTags": [],
        "extraData": [{"name":"Billing", "value":"0000-123-334"}]
    }
}
```

</details>

<details>

<summary>Modificar datos del destinatario</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "contact": {
            "name": "Juan Perez",
            "email": "example@shippify.co"
        }
    }
}
```

</details>

<details>

<summary>Modificar dirección de entrega</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "location": {
            "address": "av. echeñique 8861, 7860169 la reina, región metropolitana, chile",
            "instructions": "CLIENTE RETIRA PRODUCTOS EN POLICENTRO 2",
            "lat": -23.557166,
            "lng": -46.664559
        }
    }
}
```

</details>

<details>

<summary>Modificar etiquetas</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "addTags":[1003],
        "removeTags": []
    }
}
```

</details>

<details>

<summary>Modificar referenceId</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
        "referenceId": "0987837468"
    }
}
```

</details>

<details>

<summary>Modificar paquetes de la entrega</summary>

```json
{
    "deliveryIds": [
        "t-pruaas-4973"
    ],
    "deliveryChanges": {
       "packages": [
            {
                "id": "SSSTP002",
                "name": "XIAOMI REDMI 10S",
                "size": 2,
                "price": 0,
                "weight": 5,
                "qty": 1
            }
        ]
    }
}
```

</details>


---

# 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.shippify.co/developers/shippify-api/entregas/modificar-entrega.md?ask=<question>
```

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.
