Integração via FTP

Os registros a serem importados para o Dunning, podem ser realizados via integração FTP.

A integração FTP se baseia no envio diário de arquivos no formato .csv, .xls ou .xlsx válidos que contenham os clientes (arquivo: clientes.csv ou cliente.xls ou cliente.xlsx), seus títulos (titulos.csv ou titulos.xls ou titulos.xlsx) e as respectivas baixas (arquivo: baixas.csv ou baixas.xls ou baixas.xlsx)

Configuração: O usuário deverá acessar o DUNNING, Tela de Configurações, Integrador e habilitar a Integração via FTP. A configuração para envio dos arquivos e acesso ao FTP está realizada.

IntegraçãoFTP

Dados

O DUNNING necessita de três tabelas de dados: (1) clientes, (2) títulos e (3) baixas. Há também uma tabela de dados opcional: (4) grupos econômicos.

Para importar corretamente os seus clientes no sistema, é necessário fornecer os seguinte dados:

  1. Código do Grupo Econômico: campo texto que identifica o grupo econômico do cliente no sistema de gestão
  2. Código do Cliente (*): campo texto que identifica o cliente no sistema de gestão
  3. Nome (*): campo texto (Ex: João da Silva)
  4. Tipo de Pessoa (*): informa se é uma pessoa física ou jurídica (Ex: F, Física ou FISICA para pessoas físicas; e J, Jurídica ou JURIDICA para pessoas jurídicas)
  5. CPF/CNPJ : campo numérico de 11 ou 14 dígitos válidos para cpf ou cnpj
  6. CEP: campo número (Ex: 35570000)
  7. Endereço: campo texto
  8. Número: campo texto
  9. Complemento: campo texto
  10. Bairro: campo texto
  11. Cidade: campo texto
  12. UF: campo texto de 2 letras (Ex: MG)
  13. Email 1: primeiro e-mail
  14. Email 2: segundo e-mail
  15. Telefone 1 (DDD): campo numérico de 2 dígitos
  16. Telefone 1: campo numérico de 8 ou 9 dígitos
  17. Telefone 2 (DDD): campo numérico de 2 dígitos
  18. Telefone 2: campo numérico de 8 ou 9 dígitos
  19. Celular 1 (DDD): campo numérico de 2 dígitos
  20. Celular 1: campo numérico de 8 ou 9 dígitos
  21. Celular 2 (DDD): campo numérico de 2 dígitos
  22. Celular 2: campo numérico de 8 ou 9 dígitos
  23. Celular 3 (DDD): campo numérico de 2 dígitos
  24. Celular 3: campo numérico de 8 ou 9 dígitos
  25. Situação: informa se o cliente está ativo ou inativo
  26. Campo 1: (Opcional) campo texto personalizado
  27. Campo 2: (Opcional) campo texto personalizado
  28. Campo 3: (Opcional) campo texto personalizado
  29. Campo 4: (Opcional) campo texto personalizado
  30. Campo 5: (Opcional) campo texto personalizado
  31. Observação 1: (Opcional) campo texto de observação personalizado
  32. Observação 2: (Opcional) campo texto de observação personalizado
  33. Observação 3: (Opcional) campo texto de observação personalizado

Para importar corretamente os seus títulos no sistema, é necessário ter os seguintes dados:

  1. Código da Filial (*): campo texto que identifica a filial do título no sistema de gestão (Padrão: 1)
  2. Código do Cliente (*): campo texto que identifica o cliente no sistema de gestão
  3. Código do Título (*): campo texto que identifica o título no sistema de gestão
  4. Data de Emissão (*): campo data que informa a data de emissão (Ex: 10/08/2015)
  5. Data de Vencimento (*): campo data que informa o vencimento (Ex: 10/08/2015)
  6. Valor (*): campo numérico informando o valor do título (Ex: 104,90)
  7. Tipo: campo texto que informa o tipo do título (Ex: NF, Cartão)
  8. Nosso número: campo texto do nosso número para geração de boletos
  9. Campo 1: (Opcional) campo texto personalizado
  10. Campo 2: (Opcional) campo texto personalizado
  11. Campo 3: (Opcional) campo texto personalizado
  12. Campo 4: (Opcional) campo texto personalizado
  13. Campo 5: (Opcional) campo texto personalizado
  14. Observação 1: (Opcional) campo texto de observação personalizado
  15. Observação 2: (Opcional) campo texto de observação personalizado
  16. Observação 3: (Opcional) campo texto de observação personalizado

Para importar corretamente as baixas dos seus títulos no sistema, é necessário ter os seguintes dados:

  1. Código da Filial (*): campo texto que identifica a filial do título no sistema de gestão (Padrão: 1)
  2. Código do Cliente (*): campo texto que identifica o cliente do título no sistema de gestão
  3. Código do Título (*): campo texto que identifica o título no sistema de gestão
  4. Sequência da Baixa (*): campo numérico que identifica o número de sequência da baixa (Padrão: 1)
  5. Data da Baixa (*): campo data que informa a data da baixa (Ex: 10/08/2015)
  6. Forma de Pagamento (*): campo texto que informa o código da forma de pagamento existente no dunning (Padrão: 1 para dinheiro, 2 para boleto)
  7. Valor da Baixa (*): campo numérico informando o valor da baixa (Ex: 100,00)
  8. Valor de Juros (*): campo numérico informando o valor dos juros (Ex: 1,00)
  9. Valor de Multa (*): campo numérico informando o valor da multa (Ex: 2,00)
  10. Valor da Acréscimo (*): campo numérico informando o valor de acréscimo (Ex: 0,00)
  11. Valor de Desconto (*): campo numérico informando o valor do desconto (Ex: 0,00)
  12. Valor Recebido (*): campo numérico informando o valor total recebido (Ex: 103,00)

Para importar corretamente os grupos econômicos dos seus clientes no sistema, é necessário ter os seguintes dados:

  1. Código do Grupo Econômico (*): campo texto que identifica o grupo econômico no sistema de gestão (Padrão: 1)
  2. Nome (*): campo texto com um nome para o grupo econômico no sistema de gestão
  3. Raiz CNPJ: campo texto com a raiz do CNPJ (8 primeiros dígitos)

Após realizada a configuração, o envio FTP é realizado da seguinte forma:

  1. URL: ftp://dunning.com.br
  2. Usuário: "Código Token" Ex: NzQ2OV82NjUweMepF0WH17ZjihTbC0
  3. Senha: "" (Vazio)

Os dados enviados ao Dunning estarão disponíveis no dia seguinte à importação.