A integração do Demander com a Cayena
A Cayena é uma plataforma de abastecimento entre empresas que conecta restaurantes, mercados e hotéis a fornecedores de alimentos. Nesta integração, ela consulta o catálogo do Demander e envia os dados dos clientes e dos pedidos feitos em sua plataforma.
A comunicação começa sempre na Cayena: ela chama a API do Demander, que processa a solicitação e devolve uma resposta. O Demander não inicia o envio de dados para a Cayena. A conta e o suporte da plataforma são administrados pela própria Cayena.
Como a integração funciona
Seção intitulada “Como a integração funciona”Cada empresa configura o token de acesso, o vendedor dos pedidos, a lista de preço usada no catálogo e os de-para de status e unidades.
- A Cayena autentica com o código da empresa e o token gerado no Demander.
- Consulta os produtos ativos e seus preços na lista configurada.
- Procura o cliente pelo CPF ou CNPJ e o cadastra quando necessário.
- Envia o pedido para ser gravado no Demander.
- Acompanha o status do pedido e consulta a NF-e depois que o ERP envia os dados da nota.
O pedido é gravado com a origem Cayena, com o vendedor e com o status inicial definidos na configuração. As mudanças de status e os dados da nota fiscal seguem o fluxo normal do Demander, geralmente pela integração com o ERP.
O que cada lado faz
Seção intitulada “O que cada lado faz”| Quem | Responsabilidade |
|---|---|
| Cayena | Autenticar, consultar o catálogo, enviar clientes e pedidos e acompanhar o status e a NF-e |
| Demander | Validar as chamadas, gravar clientes e pedidos e devolver catálogo, status e dados da NF-e |
| ERP da empresa | Atualizar o status do pedido e enviar os dados da nota pela tabela 170 — Pedido Nota, incluindo chaveNfe e serieNfe |
O que precisa estar configurado
Seção intitulada “O que precisa estar configurado”Para a integração com a Cayena funcionar:
- Selecione o vendedor que receberá os pedidos da Cayena. Ele deve estar ativo e ter faixa de numeração disponível.
- Selecione a lista de preço usada para montar o catálogo. Produtos com preço zero ou com preço exclusivo de um cliente não são enviados.
- Preencha o de-para das unidades dos produtos dessa lista. Se uma unidade não estiver relacionada, a página do catálogo não será devolvida.
- Relacione o status inicial ao
orderStatusCONFIRMED e marque pelo menos um status como entregue.
Para a Cayena consultar a nota fiscal, o ERP deve enviar a chave da NF-e com 44 dígitos na nota do pedido.