DUNNING-API

O DUNNING-API é uma API na linguagem Java para facilitar a comunicação entre o Integrador e DUNNING.
Acessando facilmente às entidades (Empresas) e seus respectivos dados (Clientes e Títulos) para integração. Para o desenvolvimento de um cliente integrador na linguagem Java, é necessário o download do projeto dunning-api:

API de Integração

Clientes

https://www.dunning.com.br/api/v2/cliente?token=OTA0NV82MDA0j8pmKbNwEb0fdKJCvv

GET: obter lista de clientes

import java.util.*;
import dunning.rest.*;
import dunning.api.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = " OTA0NV82MDA0j8pmKbNwEb0fdKJCvv ";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor, token);

//obtém todos os clientes em uma lista.
List listaClientes = dunningApi.consultarClientes();

//imprime todos os clientes da empresa. 
System.out.println(listaClientes.toString());

POST: inserir/atualizar lista de clientes

import java.util.*;
import dunning.rest.*;
import dunning.utils.enums.*;
import dunning.api.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//cria uma lista de clientes
List listaCliente = new ArrayList<>();

// Exemplo de inserção de dois clientes na lista.
//Criação de Cliente 1
RestCliente c1 = new RestCliente();
c1.setNome("Cliente 1");
c1.setCpf("63184755592");
c1.setCodigoCliente("133234");
c1.setTipoPessoa(EnumTipoPessoa.FISICA); 
c1.setSituacao(EnumAtivoInativo.ATIVO);

listaCliente.add(c1); //Adiciona o Cliente 1 na lista de clientes.
						
//Criação de Cliente 2		
RestCliente c2 = new RestCliente();
c2.setNome("Cliente 2");
c2.setCpf("21897551231");
c2.setCodigoCliente("133235"); 
c2.setTipoPessoa(EnumTipoPessoa.FISICA);
c2.addEndereco("", "rua aimorés", "34", "", "centro", "Belo Horizonte", "MG"); 
c2.addEmail("teste@hotmail.com"); 
c2.setSituacao(EnumAtivoInativo.ATIVO);
//Adicionando telefones
List telefones =new ArrayList<>();
RestContatoTelefone t2=new RestContatoTelefone();
t2.setDdd("31");
t2.setNumero("971277538");
telefones.add(t2);
c2.setTelefones(telefones);
listaCliente.add(c2); //Adiciona o Cliente 2 na lista de clientes.
						
//envia a lista com os dois clientes a serem inseridos.
//caso exista um cliente com o mesmo código, este será substituído.
dunningApi.enviarClientes(listaCliente);

DELETE: remover uma lista de clientes

import java.util.*;
import dunning.rest.*;
import dunning.api.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//cria uma lista de clientes 
List listaCliente = new ArrayList<>();

// Um objeto Cliente é criado (Apenas código) para ser adicionado à lista de remoção. 
//Criação de Cliente 1
RestCliente c1 = new RestCliente();
c1.setCodigoCliente("133234");

//Adiciona o Cliente 1 na lista de clientes.
listaCliente.add(c1);
			
//Criação de Cliente 2		
RestCliente c2 = new RestCliente();
c2.setCodigoCliente("133235");
				
//Adiciona o Cliente 2 na lista de clientes.
listaCliente.add(c2);
				
//envia a lista com os dois clientes a serem removidos.
dunningApi.removerClientes(listaCliente);


Clientes (ID)

https://www.dunning.com.br/api/v2/cliente/(codigo cliente)?token=OTA0NV82MDA0j8pmKbNwEb0fdKJCvv

GET: obter cliente por código

import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//imprime dados de apenas um cliente específico (Cliente de Código: 001)
RestCliente cliente = dunningApi.consultarCliente("001");
System.out.println(cliente.toString());

DELETE: remover um cliente específico

import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//declara e informa o código do cliente a ser removido
String codigoCliente = "133234";
	
//Remove o cliente de código 133234.
dunningApi.removerRestCliente(codigoCliente);


Títulos

https://www.dunning.com.br/api/v2/cliente/(codigo cliente)/titulo?token=OTA0NV82MDA0j8pmKbNwEb0fdKJCvv

GET: obter lista de titulos

import java.util.*;
import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//declara e informa o código do cliente onde serão coletados os títulos
String codigoCliente = "001";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//imprime todos os títulos do cliente de código 001.
List listaTitulos = dunningApi.consultarRestTitulos(codigoCliente);
System.out.println(listaTitulos.toString());

POST: inserir/atualizar lista de títulos

import java.util.*;
import dunning.rest.*;
import dunning.utils.UtilFormatador;
import dunning.api.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);
				
//declara e informa o código do cliente no qual serão vinculados os novos títulos
String codigoCliente = "001";

//cria uma lista de títulos
List listaTitulos = new ArrayList<>();

// Exemplo de inserção de dois títulos na lista.
//Criação de Título 1
RestTitulo t1 = new RestTitulo();
t1.setCodigoTitulo("43332");
t1.setDataEmissao(UtilFormatador.converteStringParaDate_DDMMYYYY_BARRAS("01/12/2015"));
t1.setDataVencimento(UtilFormatador.converteStringParaDate_DDMMYYYY_BARRAS("12/12/2015"));
t1.setValor(100f);
t1.setTipo("NF");
listaTitulos.add(t1); //Adiciona o Título 1 na lista de títulos.
				
//Criação de Título 2		
RestTitulo t2 = new RestTitulo();
t2.setCodigoTitulo("43333");
t2.setDataEmissao(UtilFormatador.converteStringParaDate_DDMMYYYY_BARRAS("01/12/2013"));
t2.setDataVencimento(UtilFormatador.converteStringParaDate_DDMMYYYY_BARRAS("13/12/2013"));;
t2.setValor(120f);
t2.setTipo("Boleto");
listaTitulos.add(t2); //Adiciona o Título 2 na lista de clientes.
				
//envia a lista com os dois Títulos do cliente 001 a serem inseridos.
//caso exista um título com o mesmo código, este será substituído.
dunningApi.enviarRestTitulos(codigoCliente, listaTitulos);

DELETE: remover lista de títulos

import java.util.*;
import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);
				
//declara e informa o código do cliente que possui os títulos
String codigoCliente = "001";

//cria uma lista de títulos inserindo apenas o seu código
List listaTitulos = new ArrayList<>();

// Exemplo de inserção de dois títulos na lista. (Apenas código)
//Criação de Título 1
RestTitulo t1 = new RestTitulo();
t1.setCodigoTitulo("43332");
listaTitulos.add(t1); //Adiciona o Título 1 na lista de títulos.
				
//Criação de Título 2		
RestTitulo t2 = new RestTitulo();
t2.setCodigoTitulo("43333");
listaTitulos.add(t2); //Adiciona o Título 2 na lista de clientes.
				
//envia a lista com os dois Títulos do cliente 001 a serem removidos.
dunningApi.removerRestTitulos(codigoCliente, listaTitulos);


Títulos (ID)

https://www.dunning.com.br/api/v2/cliente/(codigo cliente)/titulo/(codigo titulo)?token=OTA0NV82MDA0j8pmKbNwEb0fdKJCvv

GET: obter título por código

import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//declara e informa o código do cliente onde será coletado o título
String codigoCliente = "001";

//declara e informa o código do título a ser coletado
String codigoTitulo = "55";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);

//imprime o título de código 55 do cliente de código 001.
RestTitulo titulo = dunningApi.consultarRestTitulo(codigoCliente, codigoTitulo);
System.out.println(titulo.toString());

DELETE: remover título específico

import java.util.ArrayList;
import dunning.api.*;
import dunning.rest.*;

//declara o servidor e respectivo token obtido.
String servidor = "https://dunning.com.br/api/v2";
String token = "OTA0NV82MDA0j8pmKbNwEb0fdKJCvv";

//inicia o DunningApi
DunningApi dunningApi = new DunningApi(servidor,token);
		
//declara e informa o código do cliente que possui o título
String codigoCliente = "001";

//declara e informa o código do Título a ser removido
String codigoTitulo = "43332";
		
//remove o título 43332 do cliente 001
dunningApi.removerRestTitulo(codigoCliente, codigoTitulo);

© Copyright 2015-2024 Direitos Reservados.