Nota Fiscal Eletrônica Manual de Integração. v1.4

Transcrição

1 Nota Fiscal Eletrônica v1.4 Página 1 de 6

2 Índice Índice... 2 Introdução... 3 Objetivo... 3 Padrões Técnicos... 3 Autenticação... 3 WSDL... 3 Operations... 3 recepcaooperation... 3 recuperardocumentooperation... 4 Endereços... 5 Disponibilidade... 6 Página 2 de 6

3 Introdução Para atender a legislação vigente, o Grupo Pão de Açúcar disponibiliza interfaces para recebimento e para recuperar arquivos de Nota Fiscal Eletrônica. Objetivo Este documento tem por objetivo descrever a utilização do WebService disponibilizado pelo Grupo Pão de Açúcar para transações relacionadas a Notas Fiscais Eletrônicas. Padrões Técnicos Basicamente, o Grupo Pão de Açúcar utiliza os mesmos padrões adotados pelo projeto de Nota Fiscal Eletrônica brasileiro. O manual utilizado como base é o do Contribuinte - versão de 16/03/2009. Autenticação O padrão de autenticação deste webservice é o mesmo adotado pelo projeto de Nota Fiscal Eletrônica nacional. do Contribuinte - versão de 16/03/2009 Para utilizar o webservice, o cliente necessita enviar o certificado digital na requisição HTTPS. WSDL O WSDL do serviço esta disponível no endereço Operations recepcaooperation Operação utilizada para o envio de arquivos de NFe para o Grupo Pão de Açúcar Parâmetros de entrada: nfecabecmsg XML de área de cabeçalho. Página 3 de 6

4 nfedadosmsg (cabecmsg_v1.02.xsd) XML de compartilhamento da NF-e. (procnfe_v1.10.xsd) Parâmetros de saída: codigoretorno mensagemretorno Código de retorno do processamento. Mensagem de retorno. Os códigos e mensagens possíveis são: Código Erro Mensagem 100 Não Arquivo recebido com sucesso. 101 Sim Erro ao validar schema. 102 Sim Acesso negado. Onde somente o valor 100 indica o sucesso da transação. Caso o envelope SOAP não esteja bem-formado será lançada uma SOAPFault: <env:envelope xmlns:env=" <env:body> <env:fault> <faultcode>env:client</faultcode> <faultstring>internal Error</faultstring> </env:fault> </env:body> </env:envelope> recuperardocumentooperation Operação utilizada para retornar o documento XML de NFe emitidas pelo Grupo Pão de Açúcar. Parâmetro de entrada: chavenfe Chave da Nota Fiscal Parâmetros de saída: codigoretorno mensagemretorno Código de retorno do processamento. Mensagem de retorno. Página 4 de 6

5 arquivoserializado Arquivo XML serializado Os códigos e mensagens possíveis são: Código Erro Mensagem 100 Não Consulta efetuada com sucesso. 101 Sim Arquivo não encontrado. 102 Sim Acesso negado. Onde somente o valor 100 indica o sucesso da transação. Caso o envelope SOAP não esteja bem-formado será lançada uma SOAPFault: <env:envelope xmlns:env=" <env:body> <env:fault> <faultcode>env:client</faultcode> <faultstring>internal Error</faultstring> </env:fault> </env:body> </env:envelope> Endereços Sugerimos que antes de utilizar o ambiente de produção para recepção de arquivos de NF-e, o fornecedor utilize o ambiente de homologação para testar o processo de recebimento. Homologação Produção ATENÇÃO: O endereço do end-point deve ser exatamente este. Não deve conter / no final nem espaços. As URLs acima aceitam somente requisições HTTP POST. Caso o servidor receba algum request diferente será retornado o seguinte SOAPFault: <env:envelope xmlns:env=" <env:body> <env:fault> Página 5 de 6

6 <faultcode>env:client</faultcode> <faultstring>internal Error</faultstring> </env:fault> </env:body> </env:envelope> Disponibilidade O serviço esta disponível 24 horas por dia, 7 dias na semana e 365 dias por ano. Exceto por problemas técnicos. Página 6 de 6