Automação de Contratos e Notas Fiscais: Conectando ERP, Asaas e DocuSign pelo n8n

Para empresas que operam no mercado B2B, a conquista de um novo cliente é motivo de comemoração, mas também o início de uma complexa rotina operacional. A jornada burocrática que envolve cadastrar o cliente no ERP, gerar a cobrança no gateway financeiro, elaborar o contrato personalizado, enviá-lo para assinatura digital e emitir a respectiva Nota Fiscal de Serviço (NFS-e) consome preciosas horas de trabalho do time de operações financeiras e jurídicas.

A centralização desses passos através de uma arquitetura de integração de APIs elimina gargalos operacionais e erros humanos. Neste guia prático, detalhamos como construir um fluxo end-to-end de automação conectando seu ERP (ou CRM), o gateway de pagamentos Asaas e a plataforma de assinaturas DocuSign utilizando o n8n.

---

O que é Automação Financeira e Jurídica Integrada?

[!NOTE] Definição Direta: Trata-se de um ecossistema de dados integrado onde a alteração de status de um negócio para “Fechado/Ganho” em um CRM ou ERP dispara sequencialmente chamadas de APIs para o gateway financeiro (criando o cadastro do cliente e a fatura correspondente) e para a plataforma de assinatura eletrônica (gerando o contrato com as variáveis do negócio preenchidas), finalizando com a emissão automática da Nota Fiscal mediante a confirmação da assinatura do documento.

---

Estrutura do Fluxo de Automação de Backoffice

O workflow automatizado é orquestrado de forma assíncrona orientada por eventos:

Gatilho / Ação	Ferramenta	Descrição Técnica
Gatilho Inicial	CRM (HubSpot/Pipedrive)	Webhook dispara quando negócio é marcado como “Ganho”.
Passo 1	n8n Orquestrador	Consolida e limpa os dados do cliente e da proposta.
Passo 2	Asaas API	Cria o registro de cliente (/customers) e emite a cobrança (/payments).
Passo 3	DocuSign API	Cria o envelope a partir de um template, injetando dados do contrato.
Passo 4 (Callback)	Webhook DocuSign	Dispara quando o contrato é totalmente assinado.
Passo 5	Asaas API (NF)	Agenda ou gera a Nota Fiscal (/payments/{id}/municipalDocument) e salva o PDF final.

---

Passo a Passo Técnico da Integração

sequenceDiagram
    participant CRM as CRM/ERP
    participant n8n as n8n (Orquestrador)
    participant Asaas as Asaas API
    participant DocuSign as DocuSign API
    
    CRM->>n8n: Webhook (Negócio Ganho)
    n8n->>Asaas: POST /customers (Cadastra Cliente)
    Asaas-->>n8n: Retorna customer_id
    n8n->>Asaas: POST /payments (Gera Cobrança)
    n8n->>DocuSign: POST /envelopes (Envia Contrato)
    DocuSign-->>n8n: Callback (Contrato Assinado)
    n8n->>Asaas: POST /payments/{id}/municipalDocument (Emite NFS-e)
    n8n->>CRM: Atualiza registro com PDF Assinado

1. Criando o Cliente e Cobrança no Asaas

Após receber os dados do CRM (CNPJ/CPF, Nome, E-mail, Telefone), o primeiro passo no n8n é criar o cliente no Asaas. Caso o cliente já exista, fazemos uma busca por e-mail ou CPF para reutilizar o identificador existente.

Exemplo de chamada HTTP via n8n para criar cobrança parcelada ou recorrente no Asaas:

POST https://api.asaas.com/v3/payments
Content-Type: application/json
access_token: $YOUR_ASAAS_API_KEY

{
  "customer": "cus_000005748930",
  "billingType": "PIX",
  "value": 2500.00,
  "dueDate": "2026-06-25",
  "description": "Prestação de Serviços de Consultoria de Arquitetura de TI - Junho 2026",
  "postalService": false
}

2. Gerando o Contrato Personalizado no DocuSign

Com a cobrança criada, estruturamos uma chamada para a API da DocuSign. Usamos o conceito de Templates na DocuSign, definindo tags de ancoragem (Anchor Tags) onde o sistema substituirá dados de forma dinâmica (como Razão Social, CNPJ, Valor e link de pagamento do Asaas).

Payload JSON simplificado enviado ao nó de HTTP Request do DocuSign para gerar o envelope de assinatura:

{
  "emailSubject": "Contrato de Prestação de Serviços - Erick Nascimento",
  "templateId": "8fa7d4b2-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "templateRoles": [
    {
      "email": "[email protected]",
      "name": "João da Silva",
      "roleName": "Contratante",
      "tabs": {
        "textTabs": [
          {
            "tabLabel": "razao_social",
            "value": "Empresa X LTDA"
          },
          {
            "tabLabel": "cnpj",
            "value": "00.000.000/0001-00"
          },
          {
            "tabLabel": "valor_contrato",
            "value": "R$ 2.500,00"
          }
        ]
      }
    }
  ],
  "status": "sent"
}

3. O Callback de Assinatura e Faturamento Automático

Para garantir total sincronia, configuramos um webhook na DocuSign (Connect) apontando para uma URL de entrada (Webhook Trigger Node) no n8n. Este evento dispara apenas quando o envelope muda de estado para Completed (assinado por todas as partes).

No recebimento deste evento:

1. Download do PDF: O n8n faz o download do contrato assinado com os certificados de validação jurídica da DocuSign.
2. Arquivamento: O arquivo é carregado em uma pasta compartilhada do Google Drive do projeto e anexado ao registro do cliente no CRM.
3. Emissão de NFS-e: O n8n localiza a cobrança criada no Asaas e envia o payload para emitir a Nota Fiscal de serviço de forma automática, reduzindo a zero a necessidade de preenchimento manual no portal da prefeitura.

Código Node.js (n8n Code Node) para preparar a geração da NFS-e:

// Prepara dados para emissão da NFS-e no Asaas após confirmação do contrato
const paymentId = items[0].json.body.customFields.asaasPaymentId;
const serviceDescription = "Serviço de Consultoria em TI conforme Contrato Assinado Digitalmente.";

return [{
  json: {
    paymentId: paymentId,
    municipalServiceCode: "1.05", // Código do serviço conforme prefeitura (Licenciamento/Desenvolvimento/Consultoria)
    description: serviceDescription,
    taxes: {
      iss: 2.0, // Alíquota do ISS do município da sua empresa
      cofins: 0.0,
      pis: 0.0
    }
  }
}];

---

Benefícios da Automatização Operacional

• Redução Drástica do Turnaround Time (TAT): O tempo entre a venda aprovada e o envio do contrato cai de horas para segundos, aumentando a taxa de conversão e a percepção de profissionalismo.
• Zero Erros de Digitação: A eliminação do processo manual de cópia e cola de dados entre o CRM, o editor de textos (Word), o portal do banco e o site da prefeitura extingue erros graves de cobrança e notas fiscais emitidas incorretamente.
• Conformidade Financeira: Faturas geradas em sincronia com o fechamento jurídico garantem um fluxo de caixa previsível e simplificam o processo de auditoria de contas a receber.