API ViaShopModa documentação

pedido/associar_codexterno

Associar número do pedido no ERP

Depois de criar o pedido no ERP, informa à loja o número que ele ganhou no ERP. Processamento assíncrono.

Ver como Markdown Baixar coleção Postman Atualizado em 18/11/2026

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étodoPOST
URLhttps://api.viashopmoda.com.br/via/pedido/associar_codexterno/{TOKEN}
CorpoObjeto JSON { ... }, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.
ProcessamentoAssíncrono. A resposta confirma que a ação entrou na fila (automacao_id). Acompanhe com automacao/consultar.

Campos #

CampoTipoObrigatórioDescrição
numero_pedidotextosimNúmero do pedido na loja (6 dígitos).
numero_pedido_externotextosimNú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):

MensagemSignificado
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.