Ir para o conteúdo principal

Manual de Implantação – Integração ILLI + F360 Finanças (via Webhook)

Visão Geral

A integração entre o sistema ILLI e o F360 Finanças permite automatizar o envio de dados financeiros, centralizando informações como:

  • Cupons fiscais (vendas)

  • Títulos de contas a pagar e receber
    Tudo isso via Webhooks — notificações em tempo real enviadas via HTTP.

1. Pré-Requisitos para Início

Antes de configurar a integração:

  • Solicite ao time do F360 o identificador único do serviço e a URL base do webhook.

  • Garanta que o CNPJ da loja esteja cadastrado corretamente no F360.

  • Consulte a documentação técnica do F360 para endpoints de centros de custo e planos de contas.

2. Endpoints Padrão

Formato da URL:

https://webhook.f360.com.br/{identificador-unico-do-servico}/{servico-consumido}

  • identificador-unico-do-servico: gerado pelo F360 e fornecido à empresa.

  • servico-consumido: indica o tipo de informação a ser enviada. Exemplos:

    • f360-cupom-fiscal

    • f360-{id}-titulo

3. Envio de Cupons Fiscais

Use o endpoint f360-cupom-fiscal para enviar registros de venda.

Requisição:

  • Método: POST

  • Content-Type: application/json

  • Envio assíncrono (o status do processamento deve ser consultado no próprio F360)

Exemplo de JSON simplificado:

{
  "NomeSistema": "ILLI",
  "Values": [
    {
      "NumeroCupom": "100001",
      "CNPJEmitente": "12345678000100",
      "Cliente": {
        "Nome": "Maria Oliveira",
        "Cpf": "12345678900"
      },
      "MeioPagamento": [
        {
          "FormaPagamento": "PIX",
          "Valor": 120.50,
          "QtdParcelas": "1",
          "Vencimento": "2025-06-01T14:30:00"
        }
      ],
      "Data": "2025-06-01T14:30:00"
    }
  ]
}

Campos obrigatórios:

  • NumeroCupom, CNPJEmitente, Data, MeioPagamento, FormaPagamento, Valor

Observações:

  • Cupons com o mesmo número devem ser enviados uma única vez.

  • Cada request deve conter cupons de um único CNPJ e dia específico.

 

 

4. Envio de Títulos (Contas a Pagar e Receber)

Use o endpoint f360-{id}-titulos para enviar registros financeiros.

Requisição:

  • Método: POST

  • Content-Type: application/json

  • Operação exclusiva para inclusão de novos registros

Exemplo de JSON simplificado:

 

{
  "titulos": [
    {
      "cnpj": "12345678000100",
      "tipoTitulo": "receber",
      "numeroTitulo": "A00123",
      "clienteFornecedor": "João da Silva",
      "detalhesClienteFornecedor": {
        "nome": "João da Silva",
        "cpfCnpj": "12345678900"
      },
      "emissao": "2025-06-01",
      "valor": 200.00,
      "tipoDocumento": "boleto",
      "contaBancaria": "Conta Banco XYZ",
      "meioPagamento": "boleto",
      "parcelas": [
        {
          "vencimento": "2025-06-30",
          "valor": 200.00,
          "numeroParcela": 1
        }
      ],
      "rateio": [
        {
          "competencia": "06-2025",
          "centroDeCusto": "Operacional",
          "planoDeContas": "Receitas",
          "numeroParcela": 1,
          "valor": 200.00
        }
      ]
    }
  ]
}

 

Campos obrigatórios:

  • cnpj, tipoTitulo, numeroTitulo, clienteFornecedor, emissao, valor, tipoDocumento, contaBancaria, meioPagamento, parcelas, rateio

Voltar ao topo