API ViaShopModa documentação

cod_externo/associar

Associar código do ERP a produto, tipo, grade ou estampa

Grava o código que o ERP usa para um produto, tipo, grade ou estampa, para o ERP localizar o registro pelo código dele.

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

O que faz #

Grava cod_externo em até 20 registros. Depois disso, as consultas aceitam ?cod_externo= e as respostas trazem o código.

Requisição #

MétodoPOST
URLhttps://api.viashopmoda.com.br/via/cod_externo/associar/{TOKEN}
CorpoLista JSON [ {...}, {...} ], até 20 itens por requisição, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.

Campos (de cada item) #

CampoTipoObrigatórioDescrição
itemtextosimproduto, tipo, grade ou estampa.
idtextosimId do registro na loja.
cod_externotextosimCódigo do ERP.

Regras #

  • Um cod_externo não pode se repetir dentro do mesmo tipo de item.
  • Variações e clientes não usam esta rota: o código externo da variação vai em estoque[].cod_externo de produto/cadastrar; o do cliente, em cliente/associar_codexterno.

Exemplo #

[
  { "item": "produto", "id": "325", "cod_externo": "ERP-VES001" },
  { "item": "grade", "id": "17", "cod_externo": "T-GG" }
]
{
  "retorno": true,
  "qtd_atualizar": 2,
  "qtd_atualizados": 2,
  "qtd_nao_atualizados": 0,
  "qtd_erros": 0,
  "atualizados": [ ... ],
  "nao_atualizados": [],
  "erros": []
}

Erros: POST enviado não é um array., Máximo de 20 itens por requisição. Enviados N., e por item Algum dos itens obrigatórios não foi enviado: item, id, cod_externo. index[N].

Pode reenviar? #

Sim.