DF-e:

Distribuição dos documentos

Por William Zipperer

Documentos Recebidos

Disponível no menu lateral esquerdo em Serviços >>> Documentos Recebidos.

Na interface de Documentos Recebidos estão os registros onde o CNPJ do nosso cliente é o Destinatário e, como opção, podem estar também os documentos onde são tomadores (CTE). Nessa tela, encontram-se diversas informações importantes para o gerenciamento do cliente referente aos documentos recebidos e armazenados pelo Systax DF-e. Nesse espaço é possível verificar os detalhes de cada Documento Fiscal (NF-e, CT-e), fazer download dos arquivos em formato xml, CSV/Excel, visualizar DANFEs e DACTEs em formato pdf, dentre diversas outras funcionalidades.

Documentos Emitidos

Disponível no menu lateral esquerdo em Serviços >>> Documentos Emitidos.

Nesta tela as colunas são semelhantes às da Consulta de “Documentos Recebidos”, a diferença está na ausência da funcionalidade de “Manifestar”, uma vez que tal recurso não se faz necessário no contexto de documentos emitidos. Na tela de Documentos Emitidos ficam os documentos de Saída emitidos pelo nosso cliente, ou seja, onde eles estão como emitentes, porém, vale ressaltar que os documentos emitidos não são capturados automaticamente do Ambiente Nacional, sendo necessário a inclusão das NFe de saída via E-mail, Upload, WebService ou Robô DF-e.

Documentos Terceiros

Disponível no menu lateral esquerdo em Serviços >>> Documentos Terceiros

Esta área permite visualizar documentos em que o seu CNPJ não está na qualidade de Emitente ou Destinatário, embora esteja relacionado no documento fiscal. Por exemplo um CTe, se estiver na condição de Remetente e/ou Tomador do serviço. Para esses e outros casos de documentos nesta condição estarão disponíveis nessa área de Documentos de Terceiros. Observação: caso o cliente faça a opção por receber documentos em que são tomadores na interface de recebidos, é possível fazer essa configuração.

Em resumo, as funções de Documentos Recebidos/Documento Emitidos e Documentos de Terceiros do Systax DF-e, garantem aos usuários da ferramenta uma maior segurança dos arquivos armazenados. Pois demonstram em tela todas as informações que o usuário necessita para a gestão referente aos documentos armazenados, emitidos e carregados para as interfaces. Podendo realizar diversas ações, como relatórios, extrações, visualização de documentos em diversos formatos dentre outras ações que a ferramenta disponibiliza para o usuário.

Integração:

API CFM: Dúvidas técnicas

Por Paulo Campos

Endereço Web: https://app.systax.com.br/v2/cfm/products/duvida_tecnica

Relembrando o conceito das API’s utilizadas no serviço de Classificação Fiscal de Mercadorias (CFM), cujo objetivo é a determinação correta de um NCM para os produtos enviados pelo cliente à Systax, dentre as funcionalidades existentes, destaca-se o serviço de consulta das dúvidas técnicas registradas pelos analistas Systax.

O objetivo principal da apresentação destas informações é informar ao usuário questionamentos efetuados pelos analistas Systax relacionados aos produtos cadastrados, para que estas dúvidas sejam esclarecidas pelo cliente, via Portal ou API CFM, o que permitirá que os analistas sigam com a classificação correta dos produtos.

Para utilização desta API, são disponibilizados os seguintes campos:

• List_ids: Campo para inserção de um ou mais ID’s (separados por vírgula) para demonstração de dúvidas inseridas nos produtos selecionados. Caso este campo seja preenchido, os campos “cod_interno” e “origem_produto” não serão considerados;
• Cod_interno: Código do material enviado no cadastro. Deve ser utilizado em conjunto com o campo “ origem_produto”;
• Origem_produto: Origem da mercadoria enviada no cadastro. Deve ser utilizado em conjunto com o campo “ cod_interno”;
• Limit: Delimita a quantidade itens a ser demonstrado para cada página da chamada.

Para que o usuário possa customizar a chamada com um dos itens acima, é necessário escrever tais informações na construção da URL.

Para facilitar o entendimento e exemplificar a construção de cada tipo de chamada, abaixo o detalhamento de cada uma:

1. Listagem completa: basta utilizar a seguinte URL padrão da API: https://app.systax.com.br/v2/cfm/products/duvida_tecnica

Note que o “Record_count”, encontrado no canto superior esquerdo da response, demonstra que 26 produtos detêm dúvida técnica, evidenciando assim a listagem completa.

2. Listagem por ID: Utilizando a URL padrão, deve-se inserir o(s) número(s) de ID de cada produto desejado* Abaixo solicitamos a listagem dos ID’s 17746220 e 17746221:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?list_ids=17746220%2C17746221

3. Listagem completa com determinação de quantidade de itens retornados: Utilizando a mesma URL anterior, apenas inserir a informação de limite, conforme demonstrado abaixo:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?limit=15

4. Listagem por Código interno e origem do produto: Utilizando a URL padrão, inserir os valores correspondentes ao campo “cod_interno” e “origem_produto” *:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?cod_interno=7950-1586&origem_produto=0

*Informações relacionadas a “ID”, “cod_interno” e “origem_produto” podem ser visualizados na response da chamada completa efetuada.

É importante ressaltar que as formas demonstradas acima são somente exemplos de como a URL deve ser inserida para que possa ser apresentada uma resposta correta, no código 200 (sucesso da chamada). Mas o usuário, caso queira apenas visualizar uma listagem completa, deve utilizar apenas a URL padrão e conseguirá visualizar todas as dúvidas técnicas criadas até o momento.

Esta API visa facilitar o entendimento e eliminar dúvidas que o usuário possa vir a ter relacionado aos produtos cadastrados no portal CFM, podendo ser atualizada no decorrer de sua utilização para abranger uma maior quantidade de questionamentos possíveis.

DF-e:

Distribution of Documents

By William Zipperer

Received Documents

Available in the left-hand menu under Services >>> Received Documents.

In the Received Documents interface, there are records where our client's CNPJ is the Recipient, and, optionally, documents where they are the service takers (CTE). In this screen, various important pieces of information for managing the client are available, regarding the documents received and stored by Systax DF-e. In this space, it is possible to check the details of each Fiscal Document (NF-e, CT-e), download files in XML, CSV/Excel format, view DANFEs and DACTEs in PDF format, among many other functionalities.

Issued Documents

Available in the left-hand menu under Services >>> Issued Documents.

This screen has columns similar to those in the "Received Documents" query, but the difference is the absence of the "Manifest" function, as this feature is not needed for issued documents. In the Issued Documents screen, you will find the outbound documents issued by our client, i.e., where they are the issuers. However, it is important to note that issued documents are not automatically captured from the National Environment, so the inclusion of outgoing NFes must be done via email, upload, web service, or DF-e robot.

Third-Party Documents

Available in the left-hand menu under Services >>> Third-Party Documents.

This area allows you to view documents where your CNPJ is neither the Issuer nor the Recipient but is still referenced in the fiscal document. For example, a CTe, if your CNPJ is the Sender and/or Service Taker. Documents in this condition will be available in this Third-Party Documents area. Note: if the client opts to receive documents in which they are service takers in the Received Documents interface, this configuration can be made.

In summary, the functions of Received Documents, Issued Documents, and Third-Party Documents in Systax DF-e ensure greater security for the stored files. They display all the necessary information on the screen for managing the stored, issued, and uploaded documents in the interfaces. Users can perform various actions, such as generating reports, extractions, viewing documents in multiple formats, among other actions the tool offers.

Integration:

CFM API: Technical questions

By Paulo Campos

Web address: https://app.systax.com.br/v2/cfm/products/duvida_tecnica

Reminding the concept of the APIs used in the service of Tax Classification (CFM), whose goal is the correct determination of an NCM for the products sent by the customer to Systax, among the existing functionalities, the service for querying technical doubts registered by Systax analysts stands out.

The main objective of presenting this information is to inform the user about questions raised by Systax analysts regarding the registered products, so that these doubts can be clarified by the customer through the Portal or CFM API, which will allow the analysts to proceed with the correct classification of the products.

To use this API, the following fields are available:

• List_ids: Field for entering one or more IDs (separated by commas) to display doubts inserted in the selected products. If this field is filled, the "cod_interno" and "origem_produto" fields will not be considered.
• Cod_interno: Code of the material submitted in the registration. It should be used in conjunction with the "origem_produto" field.
• Origem_produto: Origin of the goods submitted in the registration. It should be used in conjunction with the "cod_interno" field.
• Limit: Limits the number of items to be displayed per page of the call.

For the user to customize the request with one of the items above, it is necessary to include this information when constructing the URL.

To facilitate the understanding and exemplify the construction of each type of request, below is the detailed explanation of each one:

1. Complete listing: simply use the following default API URL: https://app.systax.com.br/v2/cfm/products/duvida_tecnica

Note that the "Record_count," found in the upper-left corner of the response, shows that 26 products have a technical doubt, thus highlighting the complete listing.

2. Listing by ID: Using the default URL, the ID number(s) of each desired product must be entered* Below, we request the listing of IDs 17746220 and 17746221:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?list_ids=17746220%2C1774622

3. Complete listing with determination of the number of items returned: Using the same previous URL, simply insert the limit information, as demonstrated below:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?limit=15

4. Listing by Internal Code and Product Origin: Using the default URL, insert the values corresponding to the "cod_interno" and "origem_produto" fields*:

https://app.systax.com.br/v2/cfm/products/duvida_tecnica?cod_interno=7950-1586&origem_produto=0

*Information related to "ID", "cod_interno", and "origem_produto" can be viewed in the response of the complete call made.

It is important to emphasize that the methods shown above are merely examples of how the URL should be entered to ensure a correct response, with code 200 (successful call). However, if the user only wants to view a complete listing, they should use the default URL and will be able to see all the technical doubts created up to that point.

This API aims to facilitate understanding and eliminate any doubts the user may have regarding the products registered in the CFM portal, and it can be updated over time to cover a larger number of possible inquiries.

Voltar