API ViaShopModa documentação

Checklist antes de ir para produção

Lista de verificação para revisar a integração antes de ligar na loja de verdade.

Ver como Markdown Atualizado em 18/11/2026

Acesso #

  • [ ] Token de produção recebido e guardado fora do código-fonte.
  • [ ] URLs de webhook cadastradas com a ViaShopModa (api@viashopmoda.com.br).
  • [ ] Cada produto é enviado com todas as variações em produto/cadastrar.
  • [ ] cod_barras único por variação.
  • [ ] Fotos enviadas por imagens/upload, com URLs sem espaços nem acentos.
  • [ ] produto/ocorrencias sem pendências nos produtos de teste.

Estoque e preço #

  • [ ] Estoque enviado como saldo final, só das variações que mudaram, em lotes de até 20.
  • [ ] Nenhuma rotina envia o estoque inteiro em intervalos curtos.
  • [ ] Preço promocional enviado em *_promo, menor que o preço normal.

Pedidos #

  • [ ] Todo pedido é importado desde a criação, pago ou não, com reserva de estoque.
  • [ ] Cancelamento libera a reserva.
  • [ ] Alteração de pedido testada: cancelamento do original + pedido novo 4 minutos depois.
  • [ ] pedido/associar_codexterno enviado depois de criar cada pedido no ERP.
  • [ ] Status enviados com os nomes exatos da loja (ex.: Aguardando Pagamento).
  • [ ] Nota fiscal enviada com pedido/atualizar_notafiscal.

Robustez #

  • [ ] No máximo 1 requisição por segundo; fila no ERP.
  • [ ] Leitura de retorno, msg_erro, msg_alerta e de nao_atualizados nos lotes.
  • [ ] 429 por segundo → espera e tenta de novo; 429 por dia → para.
  • [ ] Webhook duplicado não cria registro em dobro.
  • [ ] Conferência periódica de pedidos alterados, com folga (não polling).
  • [ ] Saldo diário acompanhado com limites_api/consultar nas primeiras semanas.