Exportação de NFS-e Recebidas e Emitidas

Índice

1. Índice

O Web Service de exportação de documentos do InvoiCy permite o download sob demanda de uma quantidade de notas em determinado período de forma agendada. Para utilizar este serviço em ambiente de produção é necessário consumir o Web Service https://consulta.invoicy.com.br/aexportardocumentos.aspx?wsdl.

Já para o ambiente de homologação deve-se consumir o seguinte Web Service https://consultahomolog.invoicy.com.br/aexportardocumentos.aspx?wsdl.

A imagem a seguir representa um exemplo de consulta de documentos.

Os campos a serem preenchidos estão representados na imagem abaixo.

É possível também realizar filtros por data de Inclusão. Nesse caso, data inicial e a data final de inclusão deverão ser preenchidas, juntamente com o horário. Ao optar por essa forma de consulta, as tags de numeração deverão ser preenchidas com zero, ou removidas da estrutura do layout enviado, e as tags de datas de emissão também deverão ser removidas. A tag da série poderá ser enviada sem informação ou removida da estrutura.

Exemplo de consulta por data de inclusão.

Na tag EmitidoRecebido você pode informar as opções: E – emitido, R – recebido.

Também é possível preencher as informações de Parâmetros, conforme o modelo abaixo:

O sistema irá retornar um protocolo, conforme modelo a seguir, informando que a consulta foi agendada e será executada em segundo plano.

Os possíveis retornos no consumo do Web Service de pedido de consulta são:
100 – Lote agendado com sucesso. Realize a consulta dos protocolos posteriormente
101 – Nenhum documento localizado na base de dados

Para consultar o protocolo, através do mesmo Web Service, modifique o conteúdo do campo Documento para o XML abaixo:

Os possíveis retornos no consumo do Web Service de consulta protocolo são:
100 – Protocolo processado
101 – Nenhum protocolo localizado na base de dados
102 – Protocolo não liberado
103 – Protocolo expirou o prazo de consulta

Caso o protocolo ainda não tenha sido processado, será retornada a mensagem abaixo:

Mas quando os documentos já estiverem prontos, o sistema irá retornar um arquivo ZIP em base64, com uma faixa de documentos e indicar qual o próximo protocolo da consulta, para serem baixados os demais documentos dessa consulta.

Para maiores informações, consulte nosso layout de exportação, clique aqui.

Outra forma de gerar a exportação, é preenchendo o campo ResumoDocumento = S. Neste caso o sistema não irá retornar um Zip com os XMLs gerados por cada prefeitura, mas sim um XML padronizado pelo InvoiCy para cada documento, mas sem as informações em Base64 do arquivo da XML da prefeitura e do documento de impressão.

Esta funcionalidade tem grande relevância considerando que diferentemente das notas emitidas, onde o seu ERP possui todas as informações sobre a nota, uma nota recebida deve permitir ao seu sistema importar os dados importantes da nota como prestador, valores, tomador, etc. Ao invés de retornarmos o XML que a prefeitura gerou, onde cada uma possui um layout diferente, realizamos a conversão em um modelo único – idêntico ao layout de emissão de RPS.

O layout completo do XML unificado de NFS-e pode ser baixado aqui.

Clique aqui para baixar os exemplos dos arquivos XML de exportação.

Para baixar exemplos XSD do layout de exportação clique aqui.