Este documento é material de especificação dos requisitos de inovaçãomanutenção, trata-se de conteúdo extremamente técnico. |
---|
Especificação | |||
Produto | TSS | Módulo | NFE |
Segmento Executor | Serviços. | ||
Chamado | TSTJQQ | ||
Release de Entrega Planejada |
| Réplica |
|
País | (X) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. |
Esta Nota Técnica consiste na implementação do pedido de prorrogação da suspensão do ICMS, na remessa para industrialização, após decorridos 180 dias.
O evento de pedido de prorrogação substitui uma petição em papel do contribuinte
,frente à administração pública, com um arquivo xml assinado.
Serão utilizados os métodos do Web Service SPEDCFGNFE
Através do método CFGCCE sera configurado a versão do Evento de Pedido de Prorrogação.
Método CFGCCE
Método de configuração dos parâmetros da Carta de Correção Eletrônica (CC-e) e Evento de Pedido de Prorrogação (EPP)
Os parâmetros de entrada do método são:
<soapenv <soapenv:Body>
<CFGCCE>
<USERTOKEN>STRING</USERTOKEN> USERTOKEN>
<ID_ENT>STRING</ID_ENT> ENT>
<AMBIENTECCE>INTEGER</AMBIENTECCE> AMBIENTECCE>
<VERCCELAYOUT>STRING</VERCCELAYOUT> VERCCELAYOUT>
<VERCCELAYEVEN>STRING</VERCCELAYEVEN> VERCCELAYEVEN>
<VERCCEEVEN>STRING</VERCCEEVEN> VERCCEEVEN>
<VERCCE>STRING</VERCCE> VERCCE>
<HORAVERAOCCE>STRING</HORAVERAOCCE> HORAVERAOCCE>
<HORARIOCCE>STRING</HORARIOCCE> HORARIOCCE>
<VEREPPLAYOUT>STRING</VEREPPLAYOUT>
<VEREPPLAYEVEN>STRING</VEREPPLAYEVEN> VEREPPLAYEVEN>
<VEREPPEVEN>STRING</VEREPPEVEN> VEREPPEVEN>
<VEREPP>STRING</VEREPP> VEREPP>
<SEQLOTECCE>INTEGER</SEQLOTECCE> SEQLOTECCE>
<SEQLOTEEPP>INTEGER</SEQLOTEEPP> SEQLOTEEPP>
</sped:CFGCCE> CFGCCE>
</soapenv:Body> Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
CFGCCE | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | CFGCCE | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | CFGCCE | A | 6 | 1-1 | ID da entidade a ser utilizada. |
AMBIENTECCE | CFGCCE | N | 1 | 1-1 | Identificação do Ambiente: 1-Produção ou 2-Homologação. |
VERCCELAYOUT | CFGCCE | A | 1-4 | 1-1 | Versão do Layout. |
VERCCELAYEVEN | CFGCCE | A | 1-4 | 1-1 | Versão do Layout do evento. |
VERCCEEVEN | CFGCCE | A | 1-4 | 1-1 | Versão do evento. |
VERCCE | CFGCCE | A | 1-4 | 1-1 | Versão da carta de correção. |
HORAVERAOCCE | CFGCCE | A | 1 | 1-1 | Identificação de Horário de Verão: 1-Sim ou 2-Não |
HORARIOCCE | CFGCCE | A | 1 | 1-1 | Identificação do Horário: 1-Fernando de Noronha; 2-Brasília e 3-Manaus |
VEREPPLAYOUT | CFGCCERESULT | A | 1-4 | 0-1 | Versão do layout do pedido de prorrogação. |
VEREPPLAYEVEM | CFGCCERESULT | A | 1-4 | 0-1 | Versão do layout do evento de pedido de prorrogação. |
VEREPPEVEN | CFGCCERESULT | A | 1-4 | 0-1 | Versão do evento do pedido de prorrogação. |
VEREPP | CFGCCERESULT | A | 1-4 | 0-1 | Versão do pedido de prorrogação. |
SEQLOTECCE | CFGCCE | N | - | 1-1 | Número sequencial do lote. |
SEQLOTEEPP | CFGCCE | N | - | 0-1 | Número sequencial do lote do evento de pedido de prorrogação . |
Os parâmetros de saída do método são:
<soap:Body>
<CFGCCERESPONSE>
<CFGCCERESULT>
<AMBIENTE>STRING</AMBIENTE>
<HORARIOCCE>STRING</HORARIOCCE>
<HORAVERAOCCE>STRING</HORAVERAOCCE>
<SEQLOTECCE>INTEGER</SEQLOTECCE>
<SEQLOTEEPP>INTEGER</SEQLOTEEPP>
<VERCCE>STRING</VERCCE>
<VERCCEEVEN>STRING</VERCCEEVEN>
<VERCCELAYEVEN>STRING</VERCCELAYEVEN>
<VERCCELAYOUT>STRING</VERCCELAYOUT>
<VEREPP>STRING</VEREPP>
<VEREPPEVEN> STRING</VEREPPEVEN>
<VEREPPLAYEVEM>STRING</VEREPPLAYEVEM>
<VEREPPLAYOUT>STRING</VEREPPLAYOUT>
</CFGCCERESULT>
</CFGCCERESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
CFGCCERESPONSE | - | - | - | 1-1 | Tag raíz. |
CFGCCERESULT | CFGCCERESPONSE |
|
|
|
|
AMBIENTE | CFGCCERESULT | A | 1 | 0-N | Identificação do Ambiente: 1-Produção ou 2-Homologação. |
HORARIOCCE | CFGCCERESULT | A | 1-4 | 1-N | Identificação do Horário: 1-Fernando de Noronha; 2-Brasília e 3-Manaus |
HORAVERAOCCE | CFGCCERESULT | A | 1-4 | 1-N | Identificação de Horário de Verão: 1-Sim ou 2-Não |
SEQLOTECCE | CFGCCERESULT | N | 1-4 | 1-N | Número sequencial do lote. |
SEQLOTEEPP | CFGCCERESULT | N | - | 1-1 | Número sequencial do lote do evento de pedido de prorrogação |
VERCCE | CFGCCERESULT | A | 1-4 | 1-N | Versão da carta de correção. |
VERCCEEVEN | CFGCCERESULT | A | 1 | 1-N | Versão do evento. |
VERCCELAYEVEN | CFGCCERESULT | A | 1 | 1-N | Versão do Layout do evento. |
VERCCELAYOUT | CFGCCERESULT | A | 15 | 1-N | Versão do Layout. |
VEREPP | CFGCCERESULT | A | 1-4 | 1-1 | Versão do evento de pedido de prorrogação. |
VEREPPEVEN | CFGCCERESULT | A | 1-4 | 1-1 | Versão do evento. |
VEREPPLAYEVEM | CFGCCERESULT | A | 1-4 | 1-1 | Versão do Layout do evento. |
VEREPPLAYOUT | CFGCCERESULT | A | 1-4 | 1-1 | Versão do Layout. |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | Código do ambiente inválido. Valores válidos: 1-Produção e 2-Homologação |
4 | Versão do Layout inválida. |
5 | Versão do Layout do evento inválida. |
6 | Versão do evento inválida. |
7 | Versão da carta de correção eletrônica inválida. |
8 | Horário de verão inválido. Valores válidos: 1-Sim e 2-Não |
9 | Horário inválido. Valores válidos: 1-Fernando de Noronha, 2-Brasilia e 3-Manaus |
Serão utilizados os métodos do Web Service NFESBRA.
Através do método REMESSAEVENTO será enviado os eventos de pedido de prorrogação e os eventos de cancelamento de pedido de prorrogação, ambos diferenciados através do TpEvento.
Método Método REMESSAEVENTO
Método destinado ao envio em lote dos novos eventos onde são tratados e enviados a SEFAZ individualmente.
Os parâmetros de entrada do método são:
<soap:Body>
<REMESSAEVENTO>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<XML_LOTE>BINÁRIO</XML_LOTE>
<REMESSAEVENTO>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
REMESSAEVENTO | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | REMESSAEVENTO | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | REMESSAEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
XML_LOTE | REMESSAEVENTO | Binário | 1-500K | 1-1 | XML do Lote de envio dos eventos, este XML será definido conforme o Layout de cada evento |
Para o envio dos eventos, foi disponibilizado um leiaute padrão para atender a todos os eventos disponibilizados para o Pedido de Prorrogação, tendo como diferencial para cada evento a tag detEvento, que deverá conter os elementos de acordo com evento a ser enviado.O Xml deverá respeitar a seguinte estrutura:
Nome | Pai | Tipo | Tamanho | Ocorrências | Observações |
---|---|---|---|---|---|
envEvento | - | - | - | 1-1 | Tag raiz |
Eventos | envEvento | G | - | 1-1 | Evento |
detEvento | Eventos | G | - | 1-N | Informações do Evento (estrutura XML variável, depende do tipo de evento) |
detEvento – Pedido de Prorrogação
Nome | Pai | Tipo | Tamanho | Ocorrências | Observações |
---|---|---|---|---|---|
detEvento | Eventos | G | - | 1-N | Tag raiz |
tpEvento | detEvento | A | 6 | 1-1 | Tipo de Evento Informar : 111500/ 111501/ 111502/ 111503 |
chNFe | detEvento | N | 44 | 1-N | Chave de Acesso da NFe. |
itemPedido | detEvento | G | - | 1-N | Grupo de Informações do item do Pedido |
numItem | itemPedido | N | 1-3 | 1-1 | Número do item da NF-e. O |
qtdeItem | itemPedido | N | 1-3 | 1-1 | Quantidade de comercialização |
Exemplo de XML para o Evento de Pedido de Prorrogação 1º e 2º prazo.
<envEvento>
<eventos>
<detEvento>
<tpEvento>111500</tpEvento>
<chNFe>99999999999999999999999999999999999999999998</chNFe>
<itemPedido>
<numItem>1</numItem>
<qtdeItem>10</qtdeItem>
</itemPedido>
<itemPedido>
<numItem>2</numItem>
<qtdeItem>12</qtdeItem>
</itemPedido>
<itemPedido>
<numItem>3</numItem>
<qtdeItem>14</qtdeItem>
</itemPedido>
</detEvento>
<detEvento>
<tpEvento>111501</tpEvento>
<chNFe>99999999999999999999999999999999999999999999</chNFe>
<itemPedido>
<numItem>1</numItem>
<qtdeItem>10</qtdeItem>
</itemPedido>
<itemPedido>
<numItem>2</numItem>
<qtdeItem>11</qtdeItem>
</itemPedido>
</detEvento>
</eventos>
</envEvento>
Exemplo de XML para evento de Cancelamento do Pedido de Prorrogação 1º e 2º prazo.
<envEvento>
<eventos>
<detEvento>
<tpEvento>111502</tpEvento>
<chNFe>99999999999999999999999999999999999999999998</chNFe>
</detEvento>
<detEvento>
<tpEvento>111503</tpEvento>
<chNFe>99999999999999999999999999999999999999999999</chNFe>
</detEvento>
</eventos>
</envEvento>
Os parâmetros de saída do método são:
<soap:Body>
<REMESSAEVENTORESPONSE>
<REMESSAEVENTORESULT>
<REMESSAEVENTORESULT>
<STRING>STRING</STRING>
<</REMESSAEVENTORESULT>
</REMESSAEVENTORESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
REMESSAEVENTORESPONSE | - | - | - | 1-1 | Tag raíz. |
REMESSAEVENTORESULT | REMESSAEVENTORESPONSE |
|
|
|
|
STRING | REMESSAEVENTORESULT | A | 54 | 0-N | Identificador do Evento, a regra de formação do Id é: “ID”+Código do Evento+Chave da NF-e+Sequencia do Evento. |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | Excedeu o limite de eventos por lote |
Método NFEMONITORLOTEEVENTO
Método destinado ao monitoramento dos lotes dos novos eventos enviados à SEFAZ
Os parâmetros de entrada do método são:
<soap:Body>
<NFEMONITORLOTEEVENTO>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<EVENTO>STRING</EVENTO>
<LOTE_INICIAL>INTEGER</LOTE_INICIAL>
<LOTE_FINAL>INTEGER</LOTE_FINAL>
<CHVINICIAL>INTEGER</CHVINICIAL>
<CHVFINAL>INTEGER</CHVFINAL>
<CHAVES>STRING</CHAVES>
</NFEMONITORLOTEEVENTO>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFEMONITORLOTEEVENTO | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | NFEMONITORLOTEEVENTO | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | NFEMONITORLOTEEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
LOTE_INICIAL | NFEMONITORLOTEEVENTO | N | 15 | 0-1 | Número do Lote Inicial |
LOTE_FINAL | NFEMONITORLOTEEVENTO | N | 15 | 0-1 | Número do Lote Final |
EVENTO
| NFEMONITORLOTEEVENTO | A | 6 | 0-1 | Código do evento a ser buscado. |
CHVINICIAL | NFEMONITORLOTEEVENTO | N | 44 | 0-1 | Chave da nfe inicial |
CHVFINAL | NFEMONITORLOTEEVENTO | N | 44 | 0-1 | Chave da nfe final |
CHAVES | NFEMONITORLOTEEVENTO | A | 1-500k | 0-1 | Numero das chaves entre aspas separada por virgula |
Os parâmetros de saída do método
<soap:Body>
<NFEMONITORLOTEEVENTORESPONSE>
<NFEMONITORLOTEEVENTORESULT>
<NFEMONITOREVENTO>
<LOTE>INTEGER</LOTE>
<ID_EVENTO>STRING</ID_EVENTO>
<AMBIENTE>INTEGER</AMBIENTE>
<PROTOCOLO>INTEGER</PROTOCOLO>
<DHREGEVEN>STRING</DHREGEVEN>
<CORGAO>INTEGER</CORGAO>
<MENSAGEM>STRING</MENSAGEM>
<MENSAGEMCANC>STRING</MENSAGEMCANC>
<STATUS>INTEGER</STATUS>
<STATUSCANC>INTEGER</STATUSCANC>
<CSTATENV>INTEGER</CSTATENV>
<CMOTENV>STRING</CMOTENV>
<CSTATEVEN>INTEGER</CSTATEVEN>
<CMOTEVEN>STRING</CMOTEVEN>
<TIPOEVENTO>INTEGER</TIPOEVENTO>
</NFEMONITOREVENTO>
</NFEMONITORLOTEEVENTORESULT>
</NFEMONITORLOTEEVENTORESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFEMONITORLOTEEVENTORESPONSE | - | - | - | 1-1 | Tag raíz. |
NFEMONITORLOTEEVENTORESULT | NFEMONITORLOTEEVENTORESPONSE | - | - | 1-1 |
|
NFEMONITOREVENTO | NFEMONITORLOTEEVENTORESULT | - | - | 1-N |
|
LOTE | NFEMONITOREVENTO | N | 1-15 | 1-1 | Lote de envio do Evento |
ID_EVENTO | NFEMONITOREVENTO | A | 54 | 0-1 | Identificador do Evento, a regra de formação do Id é: “ID”+Código do Evento+Chave da NF-e+Sequencia do Evento |
AMBIENTE | NFEMONITOREVENTO | N | 1 | 0-1 | Identificação do ambiente: 1 – Produção / 2 – Homologação |
PROTOCOLO | NFEMONITOREVENTO | A | 15 | 0-1 | Número do Protocolo da NF-e 1 posição (1-Secretaria da Fazenda Estadual,2-RFB), 2 posições para o código da UF, 2 posições para o ano e 10 posições para o sequencial no ano |
DHREGEVEN | NFEMONITOREVENTO | A | 22 | 0-1 | Data e hora de registro do evento no formato AAAA-MMDDTHH:MM:SSTZD (formato UTC, onde TZD é +HH:MM ou –HH:MM), se o evento for rejeitado informar a data e hora de recebimento do evento |
CORGAO | NFEMONITOREVENTO | N | 2 | 0-1 | Código da UF que registrou o evento. Utilizar 90 para o ambiente nacional |
MENSAGEM | NFEMONITOREVENTO | A | 1-255 | 0-1 | Mensagem de retorno do processamento |
MENSAGEMCANC | NFEMONITOREVENTO | A | 1-255 | 0-1 | Mensagem de retorno do evento de cancelamento |
STATUS | NFEMONITOREVENTO | N | 1 | 0-1 | Status do Evento [1] Evento Recebido [2] Evento Assinado [3] Evento com falha no schema XML [4] Evento transmitido [5] Evento com problemas [6] Evento registrado e vinculado a NF-e |
STATUSCANC | NFEMONITOREVENTO | N | 8 | 0-1 | Código de status do cancelamento. |
CSTATENV | NFEMONITOREVENTO | N | 8 | 0-1 | Código do status do retorno do envio do evento |
CMOTENV | NFEMONITOREVENTO | A | 1-250 | 0-1 | Descrição do status do retorno do envio do evento |
CSTATEVEN | NFEMONITOREVENTO | N | 8 | 0-1 | Código do status do retorno do evento |
CMOTEVEN | NFEMONITOREVENTO | A | 1-255 | 0-1 | Descrição do status do retorno do evento |
TIPOEVENTO | NFEMONITOREVENTO | N | 8 | 0-1 | Código do tipo de evento retornado. |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | Faixa de lotes inválida |
Método NFERETORNASEQEVENTO
Método destinado ao retorno da sequencia do evento.
Os parâmetros de entrada do método são:
<soap:Body>
<NFEMONITORLOTEEVENTO>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<CHVNFE>STRING</CHVNFE>
<TPEVENTO>INTEGER</TPEVENTO>
</NFEMONITORLOTEEVENTO>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFERETORNASEQEVENTO | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | NFERETORNASEQEVENTO | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | NFERETORNASEQEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
CHVNFE | NFERETORNASEQEVENTO | A | 44 | 1-1 | Chave da NF-e |
TPEVENTO | NFERETORNASEQEVENTO | N | 6 | 0-1 | Codigo do evento |
Os parâmetros de saida do método são:
<soap:Body>
<NFEMONITORLOTEEVENTORESPONSE>
<NFEMONITORLOTEEVENTORESULT>
<NFEMONITOREVENTO>
<NFERETSEQEVENRESULT>INTEGER</NFERETSEQEVENRESULT>
</NFEMONITOREVENTO>
</NFEMONITORLOTEEVENTORESULT>
</NFEMONITORLOTEEVENTORESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFEMONITORLOTEEVENTORESPONSE | - | - | - | 1-1 | Tag raíz. |
NFEMONITORLOTEEVENTORESULT | NFEMONITORLOTEEVENTORESPONSE |
|
|
|
|
NFEMONITOREVENTO | NFEMONITORLOTEEVENTORESULT |
|
|
|
|
NFERETSEQEVENRESULT | NFEMONITOREVENTO | N | 1 | 1-1 | Número sequencial do último evento. |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | ID do evento incorreto |
Método NFERETORNAEVENTO
Método destinado ao retorno dos eventos vinculados a nota fiscal eletrônica.
Os parâmetros de entrada do método são:
<soapenv:Body>
<NFERETORNAEVENTO>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<ID_EVENTO>STRING</ ID_EVENTO>
<EVENCHVNFE>STRING</EVENCHVNFE>
</NFERETORNAEVENTO>
</soapenv:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFERETORNAEVENTO | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | NFERETORNAEVENTO | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | NFERETORNAEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
ID_EVENTO | NFERETORNAEVENTO | A | 54 | 1-1 | Identificador do Evento, a regra de formação do Id é: “ID”+Código do Evento+Chave da NF-e+Sequencia do Evento (Opcional no caso de se querer retornar apenas um evento). |
EVENCHVNFE | NFERETORNAEVENTO | A | 44 | 0-1 | Chave da NF-e (Opcional no caso de se querer retornar todos os eventos de uma NF-e). |
Os parâmetros de saída do método são:
<soap:Body>
<NFERETORNAEVENTORESPONSE>
<NFERETORNAEVENTORESULT> <NFERETORNAEVENTORESULT>
<NFERETORNAEVENTO>
<ID<ID_ENT>STRING</ID_ENT>
<LOTE>INTEGER</LOTE>
<ID_EVENTO>STRING</ID_EVENTO>
<VERSAO>INTEGER</VERSAO>
<AMBIENTE><AMBIENTE>INTEGER</AMBIENTE>
<CORGAO>INTEGER</CORGAO>
<CSTAT>INTEGER</CSTAT>
<STATUS><STATUS>INTEGER</STATUS>
<XML_RET>STRING</XML_RET>
<XML_SIG>STRING</XML_SIG>
<XMOTIVO>STRING</XMOTIVO>
</NFERETORNAEVENTO>
</NFERETORNAEVENTORESULT>
</NFERETORNAEVENTORESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFERETORNAEVENTORESPONSE | - | - | - | 1-1 | Tag raíz. |
NFERETORNAEVENTORESULT | NFERETORNAEVENTORESPONSE | - | - |
|
|
NFERETORNAEVENTO | NFERETORNAEVENTORESULT | - | - |
|
|
ID_ENT | NFERETORNAEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
LOTE | NFERETORNAEVENTO | N | 8 | 1-1 | Lote de envio do Evento |
ID_EVENTO | NFERETORNAEVENTO | A | 54 | 1-1 | Identificador do Evento, a regra de formação do Id é: “ID”+Código do Evento+Chave da NF-e+Sequencia do Evento |
VERSAO | NFERETORNAEVENTO | N | 3 | 1-1 | Versão do Layout |
AMBIENTE | NFERETORNAEVENTO | N | 1 | 1-1 | Identificação do ambiente: 1 – Produção / 2 – Homologação |
CORGAO | NFERETORNAEVENTO | N | 2 | 1-1 | Código da UF que registrou o evento. Utilizar 90 para o ambiente nacional |
CSTAT | NFERETORNAEVENTO | N | 8 | 1-1 | Código do status da resposta do envio do evento, conforme tabela de códigos de erros e descrições de mensagens de erros |
STATUS | NFERETORNAEVENTO | N | 8 | 1-1 | Status do Evento |
XML_RET | NFERETORNAEVENTO | Binário | 1-500k | 1-1 | XML de retorno da mensagem de registro de Eventos (Layout Mensagem de Retorno), conforme Layout definido na Nota Técnica 2011/003 |
XML_SIG | NFERETORNAEVENTO | Binário | 1-500k | 1-1 | XML de envio da mensagem de registro de Eventos (Layout Mensagem Entrada), conforme Layout definido na Nota Técnica 2011/003 |
XMOTIVO | NFERETORNAEVENTO | A | 1-250 | 1-1 | Descrição do status da resposta do envio do evento, conforme tabela de códigos de erros e descrições de mensagens de erros |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | ID do evento incorreto |
Método NFEEXPORTAEVENTO
Método destinado a exportação do arquivo de xml.
Os parâmetros de entrada do método são:
<soapenv:Body>
<NFEEXPORTAEVENTO>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<ID_EVENTO>STRING</ID_EVENTO>
<CHVINICIAL>STRING</CHVINICIAL>
<CHVFINAL>STRING</CHVFINAL>
</NFEEXPORTAEVENTO>
</soapenv:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFEEXPORTAEVENTO | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | NFEEXPORTAEVENTO
| A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | NFEEXPORTAEVENTO | A | 6 | 1-1 | ID da entidade a ser utilizada. |
ID_EVENTO | NFEEXPORTAEVENTO | A | 54 | 1-1 | Id de identificação do Evento |
CHVINICIAL | NFEEXPORTAEVENTO | A | 44 | 1-1 | Chave da NFe inicial para o processamento |
CHVFINAL | NFEEXPORTAEVENTO | A | 44 | 1-1 | Chave da NFe final para o processamento |
Os parâmetros de saída do método são:
<soap:Body>
<NFEEXPORTAEVENTORESPONSE>
<NFEEXPORTAEVENTORESULT>
<STRING>STRING</STRING>
</NFEEXPORTAEVENTORESULT>
</NFEEXPORTAEVENTORESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
NFEEXPORTAEVENTORESPONSE | - | - | - | 1-1 | Tag raíz. |
NFEEXPORTAEVENTORESULT | NFEEXPORTAEVENTORESPONSE | - |
|
|
|
STRING | NFEEXPORTAEVENTORESULT | A | 54 | 0-N | XML de retorno |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade invalida |
2 | Código da entidade em branco |
3 | Entidade não Configurada para Utilizar TOTVS COLABORACAO |
TEste
<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.
<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros] | [Alteração] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA050 – Negociação Financeira] | [Envolvida] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA060 – Cadastro de Pedidos] | [Criação] | [Atualizações -> Acadêmico-> Cadastros] | - |
Exemplo de Aplicação:
Tabelas Utilizadas
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
Protótipo 01
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 01 |
X1_PERGUNT | Emissão De |
X1_TIPO | D |
X1_TAMANHO | 8 |
X1_GSC | G |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | Comum |
X1_CNT01 | '01/01/08' |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório |
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMB->AMB_CODIGO |
Método CONSULTACHAVENFE
Método destinado a exportação do arquivo de xml.
Os parâmetros de entrada do método são:
<soap:Body>
<USERTOKEN>STRING</USERTOKEN>
<ID_ENT>STRING</ID_ENT>
<CCHVNFE>STRING</CCHVNFE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
CONSULTACHAVENFE | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | CONSULTACHAVENFE
| A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
ID_ENT | CONSULTACHAVENFE | A | 6 | 1-1 | ID da entidade a ser utilizada. |
CCHAVE | CONSULTACHAVENFE | A | 44 | 1-1 | Chave de acesso da NFE, quando informado este parâmetro pelo ERP será realizada a consulta de qualquer NFE. estando ou não na base de dados.Tomando como padrão o ambiente e modalidade de consulta que está configurado nos parâmetros da Tabela SPED000. |
Os parâmetros de saída do método são:
<soap:Body>
<NFEPROTOCOLO>
<AMBIENTE>INTEGER</AMBIENTE>
<CODRETNFE>STRING</CODRETNFE>
<ID>STRING</ID>
<MSGRETNFE>STRING</MSGRETNFE>
<PROTOCOLO>STRING</PROTOCOLO>
<RECBTO>DATE</RECBTO>
<VERSAO>STRING</VERSAO>
</NFEPROTOCOLO>
</soap:Body>
Parâmetro | Tipo | Tam | Pai | Observação |
NFEPROTOCOLO | Estrutura |
|
| |
AMBIENTE | Inteiro | 001 | NFEPROTOCOLO | Ambiente de processamento da NFe. Produção ou homologação. |
CODRETNFE | Alfanumérico | 003 | NFEPROTOCOLO | Código do retorno de processamento da NFe retornado pela SEFAZ |
ID | Alfanumérico | 1-250 | NFEPROTOCOLO | Id de identificação do XML da NFe com o ERP. |
MSGRETNFE | Alfanumérico | 1-250 | NFEPROTOCOLO | Mensagem de retorno de processamento da NFe retornado pela SEFAZ |
PROTOCOLO | Alfanumérico | 15 | NFEPROTOCOLO | Número do protocolo da NFe para cancelamento, inutilização e autorização. |
RECBTO | Data | - | NFEPROTOCOLO | Data de processamento |
VERSAO | Alfanumérico | 1-20 | NFEPROTOCOLO | Versão do aplicativo de processamento |
XML_RET | Alfanumérico | 1-500k | NFEPROTOCOLO | Retorno do XML completo incluído a resposta dos métodos de EPP. (411500, 411501, 411502 e 411503) |
Soap Fault:
Fault | Descrição |
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
001 | Código da entidade invalida |
002 | Código da entidade em branco |
003 | Falha de execução da consulta na SEFAZ |
Serão utilizados os métodos do Web Service MANIFESTACAODESTINATARIO.
Através do método SINCRONIZARDOCUMENTOS é que a Sefaz envia a resposta do evento de pedido de prorrogação sendo ele diferido ou não, as respostas são armazenas na tabela SPED150 para futuras consultas.
Os parâmetros de entrada do método são:
<soap:Body>
<SINCRONIZARDOCUMENTOS>
<USERTOKEN>STRING<USERTOKEN>
<IDENT>STRING<IDENT>
<INDNFE>STRING<INDNFE>
<INDEMI>STRING<INDEMI>
</man:SINCRONIZARDOCUMENTOS>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
SINCRONIZARDOCUMENTOS | - | - | - | 1-1 | Tag raíz. |
USERTOKEN | SINCRONIZARDOCUMENTOS | A | 5 | 1-1 | Deverá ser preenchido com o valor “TOTVS”. |
IDENT | SINCRONIZARDOCUMENTOS | A | 6 | 1-1 | ID da entidade a ser utilizada. |
INDNFE | SINCRONIZARDOCUMENTOS | A | 1 | 0-1 | Indicação para quais NF-e sincronizar. Os valores possíveis são: 0 – Todas as NF-e; 1 – Somente as NF-e que ainda não tiveram manifestação do destinatário; 2 – Idem opção 1 incluindo também as NF-e que não tiveram Ciência da Operação declarada. Caso não seja informado, será utilizado o valor “0” como padrão. |
INDEMI | SINCRONIZARDOCUMENTOS | A | 1 | 0-1 | Indicação para quais emitentes buscar as NF-e para sincronizar. Os valores possíveis são: 0 – Todos os emitentes; 1 – Apenas emitentes aonde a raiz do CNPJ seja diferente do destinatário (evitando transferências entre filiais). Caso não seja informado, será utilizado o valor “0” como padrão. |
Os parâmetros de saída do método são:
<soap:Body>
<SINCRONIZARDOCUMENTOSRESPONSE>
<SINCRONIZARDOCUMENTOSRESULT>
<AMBIENTE>STRING</AMBIENTE>
<DOCUMENTOS>
<SINCDOCUMENTOINFO>
<CANCNSU>STRING</CANCNSU>
<CHAVE>STRING</CHAVE>
<CODEVENTO>STRING</CODEVENTO>
<SITCONF>STRING</SITCONF>
</SINCDOCUMENTOINFO>
</DOCUMENTOS>
<IDENT>STRING</IDENT>
<INDCONT>STRING</INDCONT>
</SINCRONIZARDOCUMENTOSRESULT>
</SINCRONIZARDOCUMENTOSRESPONSE>
</soap:Body>
Nome | Pai | Tipo | Tam. | Ocor. | Observações |
---|---|---|---|---|---|
SINCRONIZARDOCUMENTOSRESULT | - | - | - | 1-1 | Tag raíz. |
AMBIENTE | SINCRONIZARDOCUMENTOSRESULT | A | 1 | 1-1 | Ambiente consultado. Os valores possíveis são: 1 – Produção; 2 –Homologação. |
DOCUMENTOS | SINCRONIZARDOCUMENTOSRESULT | - | - | - | Tag raíz para os documentos sincronizados. |
SINCDOCUMENTOINFO | DOCUMENTOS | - | - | - | Tag raíz para as informações de um documento sincronizado |
CANCNSU | SINCDOCUMENTOINFO | A | 15 | 0-1 | NSU do cancelamento. |
CHAVE | SINCDOCUMENTOINFO | A | 44 | 0-1 | Chave do documento sincronizado. |
CODEVENTO | SINCDOCUMENTOINFO | A | 6 | 0-1 | Tipo do evento |
SITCONF | SINCDOCUMENTOINFO | A | 1 | 0-1 | Código da situação da confirmação do documento. Os valores possíveis são: 0 – Sem manifestação do destinatário; |
IDENT | SINCDOCUMENTOINFO | A | 6 | 1-1 | Código da entidade. |
INDCONT | SINCDOCUMENTOINFO | A | 1 | 1-1 | Indicador de continuação: 0 - SEFAZ não possui mais documentos para o CNPJ informado; 1 - SEFAZ possui mais documentos para o CNPJ informado, ou ainda não avaliou a totalidade da sua base de dados. |
Soup Fault:
Fault | Descrição |
---|---|
Invalid Token | O parâmetro USERTOKEN foi passado incorretamente |
1 | Código da entidade em branco. |
2 | Código da entidade inválido. |
3 | Alguma falha ocorreu no processo interno do método. |
Falha de Post | Falha de execução em post: https:// |
Na Tag CODEVENTO quando o evento sincronizado for referente ao evento de pedido de prorrogação, a tag estará preenchida com o tipo do eventos( 411500, 411501, 411502 ou 411503). Para qualquer outro tipo de evento a tag vem em branco.
Após a nota ser sincronizada corretamente os métodos abaixo estaram disponíveis para consulta:
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de |
---|
Manutenção, trata-se de conteúdo extremamente técnico. |
---|