1
O que é a DGenny e como funciona a integração
A DGenny é uma plataforma de negociação B2B com IA. Fornecedores recebem cotações via WhatsApp, negociam com um agente de IA e os valores aprovados são exportados automaticamente ao ERP. Nenhum comprador precisa ligar, trocar planilha ou acessar outro sistema.
Solicitação de Compra
→
Negociação WhatsApp + IA
→
Cotação aprovada no ERP
→
Pedido e NF no ERP
2
Endpoints essenciais — o núcleo da integração
Estes grupos de endpoints são obrigatórios para o funcionamento da plataforma. Os paths e nomes exatos serão adaptados conforme a documentação da API do seu ERP. A criticidade está indicada por endpoint.
2.1 Solicitações de Compra
GET
Listar solicitações de compra Crítico
Retorna todas as solicitações em aberto ou filtradas por período, status e centro de custo. É a tela inicial do comprador na DGenny.
GET
Buscar itens de uma solicitação Crítico
Retorna os itens (produtos, quantidades, unidades, centros de custo) de uma solicitação específica para montagem da cotação.
POST
Criar solicitação de compra Recomendado
Permite que a DGenny crie solicitações programaticamente em nome do comprador.
2.1.1 Webhook — Notificação em tempo real (ideal)
Como funciona
Em vez de a DGenny buscar solicitações periodicamente, o ERP nos notifica assim que uma nova solicitação é criada.
Nesse modelo, a DGenny fornece um endpoint para receber a notificação — sem necessidade de polling.
POST
Webhook: nova solicitação de compra criada Recomendado
O ERP dispara uma requisição para a DGenny sempre que uma nova solicitação é criada. A DGenny fornece a URL e o token de autenticação durante o onboarding. O payload deve conter o ID da solicitação — a DGenny busca os detalhes em seguida via GET.
2.2 Cotações de Compra
POST
Criar cotação a partir de solicitações Crítico
Agrupa uma ou mais solicitações em uma cotação formal. É o passo que dispara o processo de negociação com fornecedores.
POST
Adicionar fornecedores à cotação Crítico
Vincula fornecedores a uma cotação existente. São estes fornecedores que receberão a negociação via WhatsApp.
POST
Adicionar solicitações ou itens à cotação Crítico
Permite incluir novas solicitações de compra ou itens avulsos a uma cotação já criada.
POST
Adicionar valores à cotação (preço, frete, impostos) Crítico
Registra os valores negociados por item, incluindo preço unitário, frete e impostos em um único endpoint. Estes são os dados exportados ao ERP após a negociação via WhatsApp.
GET
Buscar cotação por ID Crítico
Retorna os dados completos de uma cotação para exibição e acompanhamento no painel da DGenny.
GET
Listar itens da cotação Crítico
Retorna os produtos, quantidades, especificações e valores (caso já lançados) que serão enviados aos fornecedores via WhatsApp.
GET
Listar fornecedores da cotação Crítico
Fornecedores já associados à cotação no ERP, que serão contactados pela DGenny.
PUT
Atualizar status da cotação Recomendado
Usado para avançar o status após aprovação da negociação (ex.: de "em cotação" para "aprovado").
2.3 Fornecedores / Credores
GET
Listar fornecedores Crítico
Lista paginada de todos os fornecedores cadastrados. Usada para busca e seleção no painel de cotações.
GET
Buscar fornecedor por CPF/CNPJ Crítico
Verifica se um fornecedor já está cadastrado antes de criar um novo registro.
POST
Cadastrar novo fornecedor Crítico
Cria um fornecedor no ERP a partir dos dados coletados pela DGenny (nome, CNPJ, telefone, e-mail).
PUT
Atualizar dados do fornecedor Recomendado
Atualiza telefone, e-mail ou contato de um fornecedor existente.
2.4 Obras / Centros de Custo
GET
Listar obras e centros de custo Crítico
Lista todas as obras ativas ou centros de custo da empresa para filtrar solicitações de compra por projeto.
GET
Listar empresas Recomendado
Para ERPs com múltiplas empresas/filiais, lista as entidades disponíveis para seleção do comprador.
3
Endpoints complementares — para uma experiência completa
Estes endpoints não bloqueiam o lançamento, mas melhoram significativamente a experiência dos compradores e a rastreabilidade financeira da operação.
3.1 Compradores / Colaboradores
GET
Listar compradores / colaboradores Recomendado
Lista os usuários autorizados a realizar solicitações de compra. Permite que a DGenny exiba o responsável por cada pedido.
GET
Buscar colaborador por ID Recomendado
Retorna nome, e-mail e departamento de um colaborador específico para exibição no histórico.
3.2 Pedidos de Compra
POST
Criar pedido de compra Recomendado
Converte uma cotação aprovada em pedido formal no ERP, com fornecedor, itens e preços definidos.
GET
Listar pedidos de compra Recomendado
Histórico de pedidos para acompanhamento e rastreabilidade.
3.3 Notas Fiscais de Compra (NFe)
POST
Importar NF por XML Opcional
Recebe o XML da nota fiscal para vinculação automática ao pedido de compra correspondente.
GET
Listar notas fiscais Opcional
Lista NFs para conferência e rastreio financeiro.
3.4 Contas a Pagar
GET
Listar contas a pagar Opcional
Permite que a DGenny exiba o status financeiro de pagamentos aos fornecedores.
POST
Criar conta a pagar Opcional
Gera automaticamente a conta vinculada à NF recebida.
4
Resumo dos requisitos por módulo
| Módulo | O que precisa ter | Prioridade | Sem isso... |
|---|---|---|---|
| Solicitações de Compra | Listar solicitações · Buscar itens de uma solicitação | Crítico | Não há o que cotar |
| Cotações | Criar cotação · Adicionar fornecedores · Adicionar itens · Registrar valores (preço, frete, impostos) | Crítico | Negociação não salva no ERP |
| Fornecedores | Listar fornecedores · Buscar por CNPJ · Cadastrar novo | Crítico | Não é possível convidar fornecedores |
| Obras / Centros de Custo | Listar obras ativas | Crítico | Sem filtro por obra/projeto |
| Webhook — Nova Solicitação | Notificação em tempo real quando solicitação é criada (DGenny fornece o endpoint receptor) | Recomendado | DGenny precisa fazer polling periódico |
| Compradores | Listar colaboradores autorizados | Recomendado | Responsável não aparece nos pedidos |
| Pedidos de Compra | Criar pedido · Listar pedidos | Recomendado | Pedido criado manualmente |
| Notas Fiscais | Importar NF por XML · Listar NFs | Opcional | NF vinculada manualmente |
| Contas a Pagar | Listar contas a pagar | Opcional | Sem visibilidade financeira |
5
Requisitos técnicos da API
Autenticação
Precisamos entender detalhadamente como funciona a autenticação da sua API:
tipo (Basic Auth, Bearer Token, OAuth 2.0, API Key), onde enviar a credencial
(header, query param), e como renovar o token se necessário.
Estas informações são essenciais para o início do desenvolvimento.
Ambiente de Sandbox
É ideal ter um ambiente de sandbox com credenciais de teste antes de iniciar a integração.
Isso permite validar todos os endpoints com dados fictícios sem impactar o ambiente de produção.
Formato
REST com respostas em JSON. Os detalhes de formato serão alinhados durante o onboarding técnico.
Paginação
Suporte a paginação com
page e limit (ou offset). Retornar hasMore ou total na resposta.Rate Limiting
Se houver limite de requisições, informar via header
X-RateLimit-Remaining e Retry-After no HTTP 429.Documentação
Disponibilizar Swagger/OpenAPI ou documentação equivalente agiliza significativamente o desenvolvimento da integração.
Atenção: CORS e firewall
A API do ERP será acessada pelo backend da DGenny (IP fixo fornecido no onboarding).
O acesso direto pelo browser do usuário nunca acontece — todas as chamadas partem do servidor.
Isso simplifica a configuração: basta liberar o IP do servidor DGenny.
6
Cronograma típico de integração — 45 dias
1
Semana 1
Onboarding e acesso à API
ERP libera credenciais de sandbox. DGenny valida autenticação e testa endpoints básicos de leitura (solicitações e obras).
2
Semanas 2–3
Desenvolvimento do núcleo
Integração dos endpoints críticos: solicitações, criação de cotações, fornecedores e exportação de valores negociados.
3
Semana 4
Testes end-to-end
Simulação do fluxo completo: solicitação → cotação → negociação WhatsApp → exportação ao ERP.
4
Semanas 5–6
Piloto com cliente real
Deploy em produção com um cliente selecionado. Monitoramento, ajustes finais e handoff para suporte.
Próximo passo: agende uma chamada técnica
Tem dúvidas sobre algum endpoint ou quer validar se sua API já atende aos requisitos?
Fale com o CS da DGenny que já está te atendendo — ele vai conectar você diretamente
com nosso time técnico. A chamada de onboarding leva menos de 1 hora e saímos com o
plano de integração definido.
Responsável: Igor Sempre Bom · E-mail: igor@dgenny.com.br · WhatsApp: (48) 98416-9765
Responsável: Igor Sempre Bom · E-mail: igor@dgenny.com.br · WhatsApp: (48) 98416-9765