DOCS

Update order number

/

Atualizar número do pedido

Saiba como funciona o endpoint para atualizar um número de pedido.

O endpoint updateMerchantOrderId é usado para atualizar um pedido no sistema Zonos com o ID do pedido da sua loja para uma melhor conciliação, comunicação e auditoria.

Endpoint 

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

Requisição HTTPS

CampoNotas
Método HTTPPOST
URL do Endpointhttps://api.iglobalstores.com/v1/updateMerchantOrderId
ProtocoloHTTPS
Formato da mensagemJSON
Cabeçalho HTTP AcceptAccept: application/json
Cabeçalho HTTP Content-TypeContent-Type: application/json

Pares chave/valor JSON no corpo da requisição

Exemplo

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

Definições JSON da solicitação

CampoNotas
merchantOrderId OBRIGATÓRIOEste parâmetro é usado para passar o ID do pedido interno da sua loja para o pedido no sistema da Zonos. Isso é recomendado para uma melhor conciliação, comunicação e auditoria. string
orderId OBRIGATÓRIOO ID do pedido da Zonos - pode ser passado com ou sem o ID da sua loja e hífen (Exemplo: 123-45678 ou 45678).Nota: Após a conclusão do pedido e pagamento, o cliente será redirecionado para uma página de Conclusão do Pedido / Agradecimento pelo Pedido hospedada em seu domínio. A URL conterá um parâmetro de string de consulta "orderId" que conterá esse valor. inteiro / string
secret OBRIGATÓRIOGUID secreto da API fornecido pela Zonos. string
store OBRIGATÓRIOID da loja fornecido pela Zonos. inteiro

Resposta HTTPS

Exemplo de resposta de sucesso

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

Exemplo de resposta de erro

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

Respostas de erro HTTP

Código de erroDefinição
406 - Não AceitávelEntidade HTML. O cabeçalho HTTP "Accept" é inválido.
415 - Tipo de mídia não suportadoEntidade HTML. O cabeçalho HTTP "Content-Type" é inválido.
200"error": "não foi possível analisar a entrada"
200"error": "O parâmetro orderId é necessário para processar o updateMerchantOrderId"
200"error": "O parâmetro merchantOrderId é necessário para atualizar o merchantOrderId."
200"error": "orderId: 999-99999 não é um orderId válido"
200"error": "Não foi possível recuperar o pedido para atualizar o merchantOrderId para orderId: 999-99999"
200"error": "Não foi possível processar a atualização do ID do pedido do comerciante."
200"error": "Credenciais de segurança inválidas"

Definições JSON de resposta

MensagemDefinição
errorEste parâmetro estará presente na resposta apenas quando ocorrer um erro e conterá uma descrição da causa. string
successEste parâmetro conterá um resumo da atualização. string

Esta página foi útil?