Modifica los datos de una expedición ya existente. Solo se envían los campos que querés cambiar; el resto se mantiene igual.
POST https://api.app.vonzu.es/api/v2/services/update
Cabeceras
secret-api-key: TU_API_KEY Authorization-Domain: TU_DOMINIO Content-Type: application/json
Estructura del cuerpo
Los cambios se envían dentro de un objeto update. Incluí en él únicamente los campos que quieras modificar:
{
"update": {
"reference": "MI-REFERENCIA-001",
"campo_a_modificar": "nuevo valor"
}
}
Identificación de la expedición: incluí la reference de la expedición dentro de update para indicar sobre cuál querés aplicar los cambios. Si tu integración utiliza otro identificador (por ejemplo el id interno), confirmalo con el equipo de GRIP.
Los campos aceptados son los mismos que en la creación (ver Crear una expedición), más algunos específicos de operación:
Campo | Tipo | Descripción |
| object | Actualiza la dirección de destino / origen. |
| object | Actualiza los datos de contacto. |
| array | Actualiza las franjas horarias. |
| array de string | Actualiza los códigos de barras. |
| string | Actualiza descripción o comentarios. |
| string ( | Cambia la fecha del servicio. |
| array de string | Asigna uno o varios conductores a la expedición. |
| string | Reasigna la expedición a otro cliente. |
| number | Actualiza el número de bultos. |
| object | Cambia el estado, con un campo |
| string ( | Fecha concertada con el destinatario. |
| array | Franjas horarias concertadas. |
| object | Prueba de entrega (POD): puede incluir |
| number | Actualiza el importe de reembolso. |
| string | Estado del reembolso. |
| number | Actualiza peso / volumen. |
| string | Actualiza el pagador. |
| string | Actualiza el canal. |
| string | Asigna agencia de destino / origen. |
| number | Tiempo de dedicación (minutos). |
| number | Número de retiradas. |
| number | Valor asegurado. |
| array de string | Requisitos del conductor. |
| object | Campos personalizados. |
| string | Código SSCC de la unidad logística. |
| boolean | Si es |
Ejemplo: actualización simple
Cambiar únicamente el canal de una expedición:
{
"update": {
"reference": "MI-REFERENCIA-001",
"channel": "online"
}
}
Ejemplo: actualización operativa
Asignar conductor, marcar como completada y registrar la fecha concertada:
{
"update": {
"reference": "MI-REFERENCIA-001",
"driversUsernames": ["nicoledriver2"],
"clientUsername": "Celeritas",
"packageCount": 2,
"status": { "code": "completed" },
"concertDate": "2023-07-17",
"concertSchedules": [
["00:30:00", "01:45:00"]
]
}
}
Respuesta
La API responde con estado 200 OK. Para obtener el estado actualizado de la expedición, podés consultarla con Buscar por referencia.