Integração

Piloto

O piloto prova que um ERP integra lendo só esta documentação e o Status da integração, sem abrir chamado de suporte.

O que o Sellume prepara#

• O integrador de teste já cadastrado.
• O acesso ao portal para a equipe técnica do ERP.
• A chave sk_test_, entregue por canal seguro (nunca por e-mail aberto ou chat).
• Uma ficha de exemplo com fotos que passam na conferência (a mesma estrutura da ficha de exemplo).

Checklist#

• Acesso ao portal do integrador funcionando.
• Chave sk_test_ guardada no cofre do servidor.
• Ficha de exemplo enviada e aprovada na conferência.
• As 8 etapas verdes no Status da integração.
• Pedido de produção aceito (POST/integracao/pedido-producao).

Roteiro#

O ERP integra lendo só esta documentação e o Status da integração:

1. Seguir Começar do passo 1 ao 10, com a chave de teste.
2. Implementar do lado do ERP: subconta por cliente, envio da ficha completa, leitura da conferência por tipo, pedidos com Idempotency-Key, recebimento de avisos com a assinatura conferida e respeito ao Retry-After.
3. Acompanhar o Status da integração até 8/8, corrigindo o que ele apontar.
4. Pedir o acesso de produção e criar a chave sk_live_ no portal.

Métrica de sucesso#

• Zero chamados de suporte até 8/8.
• Tempo da primeira chamada até 8/8, medido pelo registro de chamadas: da primeira chamada autenticada com sk_test_ até a última etapa verde.

Se algo falhar#

1. Pegue o X-Request-Id da resposta e abra o detalhe em GET/integracao/chamadas/{requestId} (ou no portal). Lá estão a causa daquela chamada e o como corrigir.
2. Procure o código no Catálogo de erros. A resposta de erro já traz o link em error.documentation.
3. Para avisos, veja o motivoFalha de cada entrega em GET/avisos/{avisoId}/entregas.
4. Para a conferência, leia as pendências por tipo e os resultados de cada foto (Requisitos da ficha).
5. A etapa que não fica verde traz ultimaFalha e comoConcluir no GET/integracao/status.