DOCS

Update order number

/

Actualizar número de pedido

Aprende cómo funciona el punto final para actualizar un número de pedido.

El punto final updateMerchantOrderId se utiliza para actualizar un pedido en el sistema de Zonos con el ID de pedido de tu tienda para una mejor conciliación, comunicación y auditoría.

Punto final 

POST | https://api.iglobalstores.com/v1/updateMerchantOrderId

Solicitud HTTPS

CampoNotas
Método HTTPPOST
URL del punto finalhttps://api.iglobalstores.com/v1/updateMerchantOrderId
ProtocoloHTTPS
Formato del mensajeJSON
Encabezado HTTP de aceptaciónAccept: application/json
Encabezado HTTP de tipo de contenidoContent-Type: application/json

Pares clave/valor JSON en el cuerpo de la solicitud

Ejemplo

1
2
3
4
5
6
{
  "store": "999",
  "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
  "orderId": "999-9999",
  "merchantOrderId": "12-34567"
}

Definiciones JSON de solicitud

CampoNotas
merchantOrderId REQUERIDOEste parámetro se utiliza para pasar el ID de pedido interno de su tienda al pedido en el sistema de Zonos. Se recomienda para una mejor conciliación, comunicación y auditoría. cadena
orderId REQUERIDOEl ID de pedido de Zonos - se puede pasar con o sin el ID de su tienda y guion (Ejemplo: 123-45678 o 45678). Nota: Después de completar el pedido y el pago, el cliente será redirigido a una página de Finalización de Pedido / Agradecimiento por Pedido alojada en su dominio. La URL contendrá un parámetro de cadena de consulta "orderId" que contendrá este valor. entero / cadena
secret REQUERIDOGUID secreto de API proporcionado por Zonos. cadena
store REQUERIDOID de tienda proporcionado por Zonos. entero

Respuesta HTTPS

Ejemplo de respuesta exitosa

1
2
3
{
  "success": "Updated Order: 99999 with new merchantOrderId: 12-34567"
}

Respuesta de error de ejemplo

1
2
3
{
  "error": "Could not retrieve order to updateMerchantOrderId for orderId: 99999"
}

Respuestas de error HTTP

Código de errorDefinición
406 - No aceptableEntidad HTML. La cabecera HTTP "Accept" no es válida.
415 - Tipo de medio no soportadoEntidad HTML. La cabecera HTTP "Content-Type" no es válida.
200"error": "no se pudo analizar la entrada"
200"error": "Se requiere el parámetro orderId para procesar UpdateMerchantOrderId"
200"error": "Se requiere el parámetro merchantOrderId para actualizar MerchantOrderId."
200"error": "orderId: 999-99999 no es un orderId válido"
200"error": "No se pudo recuperar el pedido para actualizar MerchantOrderId para orderId: 999-99999"
200"error": "No se pudo procesar la actualización del ID de pedido del comerciante."
200"error": "Credenciales de seguridad inválidas"

Definiciones JSON de respuesta

MensajeDefinición
errorEste parámetro solo estará presente en la respuesta cuando se haya producido un error y contendrá una descripción de la causa. string
successEste parámetro contendrá un resumen de la actualización. string

¿Fue útil esta página?