Sistema para acessar dados dos Correios através da nova API REST.
- Iniciar a conexão com a api usando suas credenciais e indicando se deve realizar a operação em produção
final var api = new T3WCorreios("usuario", "token_api", "cartao_postagem", false / true);Credenciais*
usuario = login nas ferramentas dos correiostoken_api = token gerado para seu usuário em acesso-componentes
cartao_postagem = cartão de postagem para acessa à api's restritas com os devidos acessos
false/true = Indicador se deve conectar à api em modo de produção
- Exemplo registro de prepostagem
final var remetente = new T3WCorreiosPessoa("NOME_REMETENTE", new T3WCorreiosEndereco("CEP", "LOGRADOURO", "NUMERO", "BAIRRO", "CIDADE", "SIGLA_ESTADO")).setCpfCnpj("DOCUMENTO_DO_REMETENTE");
final var destinatario = new T3WCorreiosPessoa("NOME_DESTINATARIO", new T3WCorreiosEndereco("CEP", "LOGRADOURO", "NUMERO", "BAIRRO", "CIDADE", "SIGLA_ESTADO"));
final var prepostagem = new T3WCorreiosPrepostagem(remetente, destinatario, "CODIGO_DO_SERVICO", "PESO_EM_GRAMAS", "CODIGO_FORMATO_OBJETO", "CIENTE_OBJETO_NAO_PROIBIDO");
final T3WCorreiosPrepostagem prepostagemEfetivada = api.criarPrepostagem(prepostagem);Resultado:
{
id= "XPTO_ABC123",
idCorreios= "USUARIO_INFORMADO_NO_INSTANCIAMENTO",
remetente= T3WCorreiosPessoa("NOME_REMETENTE"...),
destinatario= T3WCorreiosPessoa("NOME_DESTINATARIO"...),
codigoServico='CODIGO_DO_SERVICO',
precoServico='null',
precoPrePostagem='null',
numeroNotaFiscal='null',
numeroCartaoPostagem='',
chaveNFe='null',
listaServicoAdicional=null,
itensDeclaracaoConteudo=null,
pesoInformado='PESO_EM_GRAMAS',
codigoFormatoObjetoInformado='CODIGO_FORMATO_OBJETO',
alturaInformada='null',
larguraInformada='null',
comprimentoInformado='null',
diametroInformado='null',
ncmObjeto='null',
rfidObjeto='null',
cienteObjetoNaoProibido='1',
idAtendimento='null',
solicitarColeta='null',
codigoObjeto='CODIGO_GERADO_AUTOMATICAMENTE',
dataPrevistaPostagem='null',
observacao='null',
modalidadePagamento='1',
logisticaReversa='N',
dataValidadeLogReversa='null'
}
- Exemplo cancelamento de prepostagem
final var response_cancelamento = api.cancelarPrePostagem("USUARIO", "ID_PREPOSTAGEM"));Resultado:
{resultadoCancelamento='Cancelamento realizado com sucesso!', mensagem='null', idRecibo='null'}
A classe de testes T3WCorreiosTest.java contém implementações com valores genéricos do restante dos métodos implementados, podendo ser usada para testes/verificação de resultados.
Para sua utilização, recomenda-se a criação/configuração das seguintes variáveis de ambiente para facilitar o uso:
CORREIOS_USER_ID
CORREIOS_API_TOKEN
CORREIOS_CARTAO_POSTAGEM
CORREIOS_CNPJ
CORREIOS_CONTRATO
Sendo estes os valores que serão utilizados no instanciamento da classe de conexão com a api, citados previamente no passo 1 dos exemplos de uso.