O que faz #
Liga o pedido da loja ao pedido do ERP. É o passo que fecha a importação de cada pedido. Um pedido aceita uma única associação, e um número do ERP só pode estar em um pedido.
Requisição #
| Método | POST |
| URL | https://api.viashopmoda.com.br/via/pedido/associar_codexterno/{TOKEN} |
| Corpo | Objeto JSON { ... }, cabeçalho Content-Type: application/json |
| Token | Substitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |
| Processamento | Assíncrono. A resposta confirma que a ação entrou na fila (automacao_id). Acompanhe com automacao/consultar. |
Campos #
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
numero_pedido | texto | sim | Número do pedido na loja (6 dígitos). |
numero_pedido_externo | texto | sim | Número do pedido no ERP. |
Exemplo #
{ "numero_pedido": "111111", "numero_pedido_externo": "ERP-98765" }Aceito (entrou na fila):
{
"retorno": true,
"msg": "A automação 'pedido.cadastrar_codexterno' foi cadastrada e será processada.",
"automacao_id": "123456",
"consultar_automacao": "via/automacao/consultar/{TOKEN}?id=123456"
}Recusas (na hora):
| Mensagem | Significado |
|---|---|
numero_pedido e numero_pedido_externo são obrigatórios. | Falta um campo. |
associação já realizada. | Esse par já estava associado. Trate como sucesso. |
numero_pedido_externo já associado ao pedido NNNNNN. | O número do ERP está em outro pedido. |
pedido não encontrado. | Número da loja inexistente. |
pedido já associado ao numero_pedido_externo:X. | O pedido já tem outro número do ERP. |
Pode reenviar? #
Sim: o reenvio devolve "associação já realizada".
Onde entra no processo #
Guia Pedidos.