Integração da Tray com o seu ERP

O que muda, na prática, ao integrar com a Tray

• Estoque sai por centro de distribuição, não por saldo único. A Tray trabalha com múltiplos CDs e o seu ERP com depósitos ou filiais. O mapa entre os dois precisa existir antes da primeira carga — é ele que define o que a loja pode vender e de onde a entrega sai. A rota é dedicada: PUT /multicd/distribution-centers/{id}/stock.
• Preço é campo do produto; estoque por CD é endpoint próprio. Não existe rota exclusiva para o preço base — ele viaja junto do produto ou da variação. Já o estoque por centro de distribuição tem rota separada. Essa assimetria muda o desenho da fila de sincronização e costuma ser descoberta tarde.
• O ritmo tem teto: 180 requisições por minuto e 10 mil por dia. São 50 mil diárias em contas corporativas. Uma carga completa de catálogo sem envio incremental consome a cota antes de terminar, então sincronizar apenas o que mudou deixa de ser refinamento e vira requisito.
• A autenticação é OAuth 2.0, com o token na query string. O lojista autoriza o aplicativo em /auth.php, o integrador recebe Consumer Key e Consumer Secret, e o access_token viaja como parâmetro nas chamadas.
• Não há ambiente de teste dedicado. A homologação acontece em uma loja compartilhada, o que exige cuidado com dados reais desde o começo do projeto.
• Listas de preço B2B são um recurso à parte. Se a operação vende no atacado pela mesma loja, as listas B2B têm endpoints próprios e precisam entrar no escopo — não são cobertas pelo preço padrão do produto.