Web Service
Publicado em
13/03/2020 11h28
Atualizado em
30/06/2023 09h03
O Web Service disponibiliza o serviço que será utilizado pelo (sistema cliente usado pelo) operador portuário. O mecanismo de utilização do Web Service segue as seguintes premissas:
- O envio da solicitação e a obtenção do retorno serão realizados na mesma conexão através de um único método.
- O endereço para acesso ao web-service em ambiente de produção é:
https://www4.receita.fazenda.gov.br/carga-ws/cargadescarga/Cargadescarga.wsdl
- A empresa deve adaptar sua aplicação para gerar as informações do Boletim e transmitir à RFB via web-service através deste endereço, de acordo com os padrões da tecnologia. Caso este link seja acessado diretamente através de um browser, será exibido apenas o wsdl do web service;
- As informações são enviadas ou recebidas dos Web Services através de mensagens no padrão XML definido no arquivo XSD do Web Service (boletim-carga-descarga.xsd), disponível em:
- A estrutura para a assinatura digital está definida no arquivo xmldsig-core-schema.xsd, disponível em:
- O processo de utilização do Web Service sempre é iniciado pelo órgão conveniado enviando uma mensagem nos padrões XML e SOAP, através do protocolo SSL com autenticação mútua.
- A ocorrência de qualquer erro na validação do XML Schema, Assinatura Digital, Usuário Cadastrado ou um erro inesperado será interrompido o processo e retornará um XML contendo o código e a descrição do erro, caso ocorra qualquer problema nos dados básicos do boletim (escala, terminal, tipo de operação e/ou tipo de carga) será interrompido o processo e retornará um XML contendo o número de protocolo de envio, o código e a descrição do erro, mas caso ocorra qualquer problema nos dados de um item do boletim não será interrompido o processo, os itens com os dados corretos serão registrados e retornará um XML contendo o número de protocolo de envio e para cada item o código e a descrição do erro ou sucesso na mesma ordem em que os itens foram enviados.