Controle de Numeração¶
Essa funcionalidade do CTePack tem como objetivo prover automaticamente ao usuário, a numeração dos documentos enviados para a SEFAZ. É de responsabilidade do CTePack, manter essa informação atualizada.
O controle de numeração do CTePack pode ser utilizado de duas formas:
1 - Controlar somente o número¶
Através dessa forma, é possível integrar um CT-e sem a informação de número. O sistema irá assumir a emissão com número 1, sempre incrementando o número.
Configuração¶
Não é necessário ter nenhuma configuração ativa. Salvo casos em que o usuário queira emitir a partir de um derminado número. Sendo assim é necessário indicar o último número utilizado, inserindo um registro na tabela CONTRO_NUMERA_EDOC indicando o CNPJ do emissor, modelo (57) e série, conforme segue:
1 2 | INSERT INTO CONTRO_NUMERA_EDOC (CNPJ, MODELO, SERIE, ULTIMO_NUMERO, DATA_GERACAO)
VALUES (9999999999999, 57, 1, 50, GETDATE())
|
Se for a primeira emissão e não tiver registros configurados na tabela CONTRO_NUMERA_EDOC, será adotado número inicial do CTe = 1.
Integração¶
- Banco de dados: Informar a coluna INTERF_CTE_XML.B_NCT valor = 0.
- Arquivo (XML): Informar a tag <nCT> com valor = 0 ou remover essa tag do XML.
- WebService: Informar a tag <nCT> com valor = 0 ou remover essa tag do XML.
Para mais informações sobre essa estrutura de integração acesse: RecepcionarCTe
2 - Controlar série e número¶
Esta forma possibilita ao usuário maior controle da operação, cadastrando uma série padrão e a numeração inicial desejada.
Configuração¶
O primeiro passo é configurar o(s) servidor(es) de cache que serão utilizados pelas empresas. Sem essa informação, a configuração do controlador de numeração não será habilitada. Acessar o menu Configurações > Sistema:
Na configuração do sistema existe a aba “Servidores de cache” onde é possível adicionar, visualizar, editar e remover os dados dos servidores de cache.
Clicando no botão “Novo” é exibida uma tela para preenchimento das informações do servidor:
Tendo finalizado o cadastro do servidor de cache, o próximo passo é preciso fazer um apontamento agora no cadastro da empresa direcionando para o servidor de cache que gostaria de utilizar. Acessar as configurações da empresa no menu Configurações > Grupo de empresa:
Expanda o grupo em que a empresa está localizada e clique no botão Editar da empresa desejada:
Na aba “Controle de Numeração”, habilitar a configuração “Utiliza controle de numeração”. Será exibido campos para cadastro:
- Série padrão: Essa será a série padrão que o CTePack utilizará para geração dos documentos.
- Último número: Esse é o último número válido utilizado pelo CTePack para autorização de um documento e que será incrementado automaticamente ao autorizar um documento para SEFAZ.
- Servidor de cache: Selecionar qual servidor de cache será utilizado que foi cadastrado anteriormente.
Integração¶
- Banco de dados: Informar as colunas INTERF_CTE_XML.B_NCT e INTERF_CTE_XML.B_SERIE valor = 0.
- Arquivo (XML): Informar as tags <nCT> e <serie> com valor = 0 ou remover essas tags do XML.
- WebService: Informar as tags <nCT> e <serie> com valor = 0 ou remover essas tags do XML.
Quando é habilitada essa forma de controle de numeração do CTePack integrando via WebService, é obrigatório informar um identificadorOperacao para controle interno do CTePack, conforme estrutura abaixo:
1 2 3 4 5 6 7 | <?xml version="1.0" encoding="ISO-8859-1"?>
<IntegracaoCTe>
<CTe xmlns="http://www.portalfiscal.inf.br/cte">
<!--dados do cte-->
</CTe>
<IdentificadorOperacao>234872847</IdentificadorOperacao>
</IntegracaoCTe>
|
Para mais informações sobre essa estrutura de integração acesse: RecepcionarCTe
Casos de falha¶
Assumindo que existam falhas no processo de comunicação (oscilação, falhas de rede, etc), o ERP pode ficar sem receber a resposta do WebService do CTePack contendo a chave do CTe integrado. Para situações como essa, o ERP poderá realizar uma consulta do CTe pelo identificadorOperacao passado na integração.
Acesse a documentação sobre ConsultarCTe para visualizar os XMLs de integração e suas respectivas respostas.
A proposta desta consulta é possibilitar o ERP de identificar como está a situação deste CT-e e poder reintegrá-lo em caso de rejeições. Neste caso, o ERP irá reintegrar o CTe contendo as informações de série e número retornadas através da consulta do CTe.
Segue abaixo uma tabela comparativa com os principais cenários de integração de acordo o controle de numeração ativado ou desativado. Os campos marcados com X são informados na integração com valor aleatório.
Resultado da integração | ||||
---|---|---|---|---|
ID | Série | Número | CTePack controla numeração | CTePack não controla numeração |
X | X | X | Integra com sucesso | Integra com sucesso (ID ignorado) |
X | Integra com sucesso | Crítica de integração | ||
X | X | 0 | Integra com sucesso | Integra com sucesso (ID ignorado) |
Crítica de integração | Crítica de integração | |||
0 | Crítica de integração | Crítica de integração | ||
X | 0 | Crítica de integração | Integra com sucesso | |
X | 123 | Integra com sucesso | Integra com sucesso |