Histórico da Página

Tempo aproximado para leitura: 10 min

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Tratamento da NF-e NT 2021.004 no produto TOTVS Varejo Supermercados - Linha RMS.

03. SOLUÇÃO

Alterações na NT 2021.004:

Inclusão do grupo de FCP ST no Grupo de Partilha do ICMS (Grupo N10a).

Alteração necessária para atender o Estado do Paraná, que instituiu o FCP ST nas operações com veículos novos sujeitos a ST.  Precisou ser criado o campo especifico para o FCP ST, pois não havia nesse grupo. 

Inclusão do Grupo Observações de uso livre do Fisco (para o item da NF-e)

Informações adicionais a nível de item, tanto de interesse do fisco quanto do contribuinte.

Inclusão do campo Tipo do Ato Concessório (campo: tpAto) no Grupo de Informações Adicionais da NF-e (campo: infAdic)

Este campo, que fica por sua vez dentro do Grupo de Processo Referenciado visa trazer uma identificação a mais para os Atos Concessórios cujo indicador da origem do processo seja informado como originado na SEFAZ (indProc = 0).

04. DEMAIS INFORMAÇÕES

Procedimentos:

Objetivo

Método que permite inserir/atualizar os dados do produto composto, incluindo os dados de produto componente, quantidades, etc.

Não é obrigatório o envio dessa informação quando não for utilizado o conceito de Produto Composto.

Chamada

POST /api/v1/importacao/produto/componenteprodutocomposto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do produto final que é gerado após a finalização da composição.

Código sequencial do produto que serão componentes na composição do produto final acabado, que deverá estar previamente cadastrada no WMS.

Número da empresa ou código do depositante (quando utilizado Operador Logístico).

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação dos componentes do produto, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário. 

1. O produto final (SeqProdFinal) deverá estar cadastrado previamente na empresa (NroEmpresa) informada. 
2. O produto componente (SeqProdComponente) deverá estar cadastrado previamente na empresa (NroEmpresa) informada. 
3. A embalagem (QtdEmbalagem) deverá estar cadastrada previamente para o SeqProdComponente informado. 

_{***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

[
  {
  	"seqProdFinal": 120612,
  	"seqProdComponente": 12987,
  	"nroEmpresa": 100,
  	"qtdEmbalagem": 1,
  	"quantidade": 15
  }
]

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

• OK (201)
• BadRequest (400)

Objetivo

Método que permite inserir/atualizar os dados do produto composto, incluindo os dados de produto componente, quantidades, etc.

Não é obrigatório o envio dessa informação quando não for utilizado o conceito de Produto Composto.

Chamada

POST /api/v1/importacao/produto/componenteprodutocomposto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

Código sequencial do produto final que é gerado após a finalização da composição.

Código sequencial do produto que serão componentes na composição do produto final acabado, que deverá estar previamente cadastrada no WMS.

Número da empresa ou código do depositante (quando utilizado Operador Logístico).

*Campos Obrigatórios

Validações Logísticas

Objetivo

Método que permite inserir/atualizar o produto.

Chamada

POST api/v1/importacao/produto

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Não há.

Parâmetros do Corpo (Body Parameters)

*Campos Obrigatórios

Validações Logísticas

As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação do produto, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística**

, e o registro ficará pendente de verificação por um usuário. 

1. O

1. Tipo de Endereço (CodTipEndereco) deverá estar cadastrado previamente

1. no Cadastro de Tipos de Endereco (WMS Parâmetros → Cadastro → Endereço → Tipos de Endereços);
2. O Tipo da Separação (TipSeparacao

1. ) deverá estar cadastrado previamente

1. no Cadastro de Atributos Fixos, na opção Tipo de Atributo: Tipo de Separação (WMS Parâmetros → Cadastro → Atributos Fixos);
2. O Tipo da Armazenagem (TipArmazenagem) deverá estar cadastrado previamente no Cadastro de Atributos Fixos, na opção Tipo de Atributo: Tipo de Armazenagem (WMS Parâmetros → Cadastro → Atributos Fixos);
3. O Fornecedor (SeqFornecedor) deverá estar cadastrado previamente no sistema;
4. O Produto Base (SeqProdutoBase) não poderá estar relacionado a outro produto;
5. O Produto Base (SeqProdutoBase) não poderá ter a propriedade Pesável diferente do produto relacionado.

_{**As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática.}

Formatos de Request (Request Formats)

application/json, text/json

PDV

Tratamento dos campos:

Criação dos campos novos da NT 2021.004:

Tabela AG1PDVPD:

PDV_MSG_ITEM_CONTRIBUINTE    VARCHAR2(60) - MENSAGEM ITEM CONTRIBUINTE
PDV_MSG_ITEM_FISCAL                  VARCHAR2(60) - MENSAGEM ITEM FISCAL
PDV_MSG_GENERICA_FISCAL         VARCHAR2(60) - MENSAGEM GENERICA FISCAL

Tabela AG1WPDVX:

PDVX_MSG_ITEM_CONTRIBUINTE    VARCHAR2(60) - MENSAGEM ITEM CONTRIBUINTE
PDVX_MSG_ITEM_FISCAL                  VARCHAR2(60) - MENSAGEM ITEM FISCAL
PDVX_MSG_GENERICA_FISCAL         VARCHAR2(60) - MENSAGEM GENERICA FISCAL

Alteração na PC_RMS_PDV_EXPORTACAO:

Buscar as mensagens por item (Contribuinte e Fiscal). Caso não existam, buscar a mensagem genérica fiscal.

Tabela AG1PDVCC:

PDVCC_FST_DFD_VAL - Valor FCP ST DIFAL|Valor FECOP-ST DIFAL Destino
PDVCC_IST_DFD_VAL - Valor ICMS ST DIFAL|Valor ICMS ST DIFAL Destino
PDVCC_FCP_DFD_VAL - Valor FCP DIFAL|Valor FECOP DIFAL Destino

Tabela AG1PDVCI:

PDVCI_FST_DFD_BAS - Base FCP ST DIFAL|Base FECOP-ST DIFAL Destino
PDVCI_FST_DFD_VAL - Valor FCP ST DIFAL|Valor FECOP-ST DIFAL Destino
PDVCI_FST_DFD_ALQ - Aliq. FCP ST DIFAL|Aliquota FECOP-ST DIFAL Destino
PDVCI_IST_DFD_BAS - Base ICMS ST DIFAL|Base ICMS ST DIFAL Dstino
PDVCI_IST_DFD_VAL - Valor ICMS ST DIFAL|Valor ICMS ST DIFAL Destino
PDVCI_IST_DFD_ALQ - Aliq. ICMS ST DIFAL|Aliquota ICMS ST DIFAL Destino
PDVCI_FCP_DFD_BAS - Base FCP DIFAL|Base FECOP DIFAL Destino
PDVCI_FCP_DFD_VAL - Valor FCP DIFAL|Valor FECOP DIFAL Destino
PDVCI_FCP_DFD_ALQ - Aliq. FCP DIFAL|Aliquta FECOP DIFAL Destino
PDVCI_EAN_COM_XML - EAN Com. XML|EAN da Unidade Comercial do XML
PDVCI_UNI_COM_XML - Uni. Com. XML|Unidade Comercial do XML
PDVCI_QTD_COM_XML - Qtd. Com. XML|Quantidade Comercial do XML
PDVCI_EAN_TRB_XML - EAN Trib. XML|EAN da Unidade Tributavel do XML
PDVCI_UNI_TRB_XML - Uni. Trib. XML|Unidade Tributavel do XML
PDVCI_QTD_TRB_XML - Qtd. Trib. XML|Quantidade Trib do XML
PDVCI_IDE_FIS - Ide. Obs. Fisco|Identificacao do campo de Observacao do Fisco
PDVCI_OBS_FIS - Obs. Fisco|Observacao do Fisco
PDVCI_IDE_CTR - Ide. Obs. Ctb.|Identificacao do campo de Observacao do Contribuinte
PDVCI_OBS_CTR - Obs. Ctb.|Observacao do Contribuinte

Tabela PDV_WSIMPORTLOGAG1PDVCC:

PDVCC_FST_DFD_VAL - Valor FCP ST DIFAL|Valor FECOP-ST DIFAL Destino
PDVCC_IST_DFD_VAL - Valor ICMS ST DIFAL|Valor ICMS ST DIFAL Destino
PDVCC_FCP_DFD_VAL - Valor FCP DIFAL|Valor FECOP DIFAL Destino

Tabela PDV_WSIMPORTLOGAG1PDVCI:

 "descReduzida": "Teste reduzida",
  "statusCompra": "A",
  "statusVenda": "A",  
  "tipArmazenagem": "N",
  "tipSeparacao": "N",
  "pzoValidadeDia": 100,
  "pesavel": "N",
  "emtEtiqueta": "N",
  "indProcFabricacao": "S",
  "medVDiaGeral": 1500.000000,
  "exgNroLote": "N",
  "seqProdutoBase": 1,
  "advArmazenagem": "Teste Advertencia",
  "refFabricante": "Teste Ref.Fabricante",
  "exgNroSerie": "N",
  "qtdTolArmazProd": 1,
  "referencia": "Teste Referencia",
  "utzEstrutDriveIn": "N",
  "exgCertificado": "N",
  "indAltoRisco": "N",
  "indExgValidacaoMontagemPalete": "N",
  "qtdVolGeraEtqMaster": null,
  "seqFamilia": null,
  "indControlaTemperatura": "N",
  "indControlaRastreabilidade": "N",
  "qtdDiasControleQuarentena": 1,
  "usuarioAlteracao": "CONSINCO",
  "embalagensProduto": [
    {        
	  "qtdEmbalagem": 1,
  	  "embalagem": "UN",
  	  "statusEmbalagem": "A",
  	  "indMiudezaGrandeza": "M",  
  	  "indEmbalado": "S",
  	  "codTara": "1",
  	  "pesoBruto": 1.5,
  	  "pesoLiquido": 1.25,
  	  "altura": 50.12,
  	  "largura": 25.0,
  	  "profundidade": 25.0,
  	  "pesoMedio": 1.5,
	  "indPadraoEmbCompra": "S",
  	  "indPadraoEmbVenda": "N"       
	}
  ],
  "codigosBarrasProduto": [
    {       
	  "qtdEmbalagem": 1.0,
      "codAcesso": "1234567890",
      "tipCodigo": "B"     
	}
  ],
  "especiesEnderecoProduto": [
    {         
	  "qtdEmbalagem": 12,
      "especieEndereco": "A",
      "paleteLastro": 10,
      "paleteAltura": 1,
      "estqMinimoRep": 10      
	}
  ]
  "categoriaProduto": {
    "nroDivisao": 1,
    "seqCategoria": 102
  },
  "componentesProdutoComposto": [
    {
  	  "seqProdComponente": 12987,
  	  "qtdEmbalagem": 1,
  	  "quantidade": 15
    }
  ]
}

{
 

 "seqProduto": 11,
  

"

nroEmpresa": 

100,  
  

"

seqFornecedor": 

752,
  

"

tipCodigo": 

"I",
  

"

codTipEndereco": 

"N",
  

"

descCompleta": 

"Teste descriçao completa",
 

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

1. OK (201)
2. BadRequest (400)

Requisições para adicionar as informações complementares do Produto:

Totvs custom tabs box
tabs Embalagem do Produto, Código de Barras do Produto, Espécie de Endereço do Produto, Categoria do Produto, Componentes do Produto Composto ids passo1,passo2,passo3,passo4,passo5
Conversão de NFC-e Tratamento dos campos: Criação dos campos novos da NT 2021.004: Tabela AG3VNFCC e tabelas mensais AG3VNFCC_aaaamm: NFCC_FST_DFD_VAL - Valor  do FCP ST do DIFAL NFCC_IST_DFD_VAL - Valor do ICMS ST do DIFAL NFCC_FCP_DFD_VAL - Valor do FCP ICMS do DIFAL Tabela AG3VNFCI e tabelas mensais AG3VNFCI_aaaamm: NFCI_FST_DFD_BAS - Base de Cálculo do FCP ST do DIFAL NFCI_FST_DFD_VAL - Valor  do FCP ST do DIFAL NFCI_FST_DFD_ALQ - Alíquota do FCP ST do DIFAL  NFCI_IST_DFD_BAS - Base de Cálculo do ICMS ST do DIFAL NFCI_IST_DFD_VAL - Valor do ICMS ST do DIFAL NFCI_IST_DFD_ALQ - Alíquota do ICMS ST do DIFAL NFCI_FCP_DFD_BAS - Base de Cálculo do FCP ICMS do DIFAL NFCI_FCP_DFD_VAL - Valor do FCP ICMS do DIFAL NFCI_FCP_DFD_ALQ - Alíquota do FCP ICMS do DIFAL NFCI_EAN_COM_XML - EAN da Unidade Comercial do XML NFCI_UNI_COM_XML - Unidade Comercial do XML NFCI_QTD_COM_XML - Quantidade Comercial do XML NFCI_EAN_TRB_XML - EAN da Unidade Tributável do XML  NFCI_UNI_TRB_XML - Unidade Tributável do XML         NFCI_QTD_TRB_XML - Quantidade Tributável do XML      NFCI_IDE_FIS - Identificação do campo de Observação do Fisco NFCI_OBS_FIS - Observação do Fisco NFCI_IDE_CTR - Identificação do campo de Observação do Contribuinte NFCI_OBS_CTR - Observação do Contribuinte Tabela AG3VNFCI_202104 sem os campos novos Image Removed Executando o programa de NFC-e – VGTUNFCE Image Removed Mensagem da conversão Image Removed Conversão efetuada Registro da NFC-e - Seleção Image Removed Consulta da NFC-e Image Removed Campos novos adicionados ao registro Image Removed Tabela alterada Image Removed Conversão do Fiscal Mensal Tratamento dos campos: Criação dos campos novos da NT 2021.004. Campos novos na tabela AA1FFISC e tabelas mensais AA1FFISC_aaaamm: FISC_FST_DFD_BAS - Base de Cálculo do FCP ST do DIFAL FISC_FST_DFD_VAL - Valor  do FCP ST do DIFAL FISC_IST_DFD_BAS - Base de Cálculo do ICMS ST do DIFAL FISC_IST_DFD_VAL - Valor do ICMS ST do DIFAL FISC_FCP_DFD_BAS - Base de Cálculo do FCP ICMS do DIFAL FISC_FCP_DFD_VAL - Valor do FCP ICMS do DIFAL FISC_ICM_DIF_BAS - Base de Cálculo do ICMS Diferido FISC_ICM_DIF_VAL - Valor do ICMS Diferido Campos novos na tabela AA1FFISI e tabelas mensais AA1FFISI_aaaamm: FISI_FST_DFD_BAS - Base de Cálculo do FCP ST do DIFAL FISI_FST_DFD_VAL - Valor  do FCP ST do DIFAL FISI_FST_DFD_ALQ - Alíquota do FCP ST do DIFAL  FISI_IST_DFD_BAS - Base de Cálculo do ICMS ST do DIFAL FISI_IST_DFD_VAL - Valor do ICMS ST do DIFAL FISI_IST_DFD_ALQ - Alíquota do ICMS ST do DIFAL FISI_FCP_DFD_BAS - Base de Cálculo do FCP ICMS do DIFAL FISI_FCP_DFD_VAL - Valor do FCP ICMS do DIFAL FISI_FCP_DFD_ALQ - Alíquota do FCP ICMS do DIFAL FISI_ICM_DIF_BAS - Base de Cálculo do ICMS Diferido FISI_ICM_DIF_VAL - Valor do ICMS Diferido FISI_ICM_DIF_ALQ - Alíquota ICMS Diferido FISI_EAN_COM_XML - EAN da Unidade Comercial do XML FISI_UNI_COM_XML - Unidade Comercial do XML FISI_QTD_COM_XML - Quantidade Comercial do XML FISI_EAN_TRB_XML - EAN da Unidade Tributável do XML  FISI_UNI_TRB_XML - Unidade Tributável do XML         FISI_QTD_TRB_XML - Quantidade Tributável do XML      FISI_IDE_FIS     - Identificação do campo de Observação do Fisco FISI_OBS_FIS     - Observação do Fisco FISI_IDE_CTR     - Identificação do campo de Observação do Contribuinte FISI_OBS_CTR     - Observação do Contribuinte Tabela AA1FFISI_202104 sem os campos novos Image Removed Executando o Fiscal Mensal – VGLFFISC Image Removed Mensagem da conversão Image Removed Conversão efetuada Image Removed Registro Fiscal Mensal – Seleção Image Removed Notas Fiscais Image Removed Importação da nota Image Removed Nota importada Image Removed Consulta da nota - Campos novos Image Removed Tabela alterada Image Removed Importação de Notas (Arquivo) Leiaute de importação FIS0001_VGLIMPFS_Layout_de_Importação_de_Movimentos_Fiscais Tratamento dos campos: Campos novos na tabela AW1IMPNI: IMPNI_IDE_FIS - Identificação do campo de Observação do Fisco IMPNI_OBS_FIS - Observação do Fisco IMPNI_IDE_CTR - Identificação do campo de Observação do Contribuinte IMPNI_OBS_CTR - Observação do Contribuinte Inclusão do Registro 12 - Observações do Item com os novos campos de Observações do Item Arquivo texto Importação da nota fiscal de número 200324 Image Removed Registros novos Image Removed Importação de notas (VGLIMPFS) Image Removed Crítica do processamento Image Removed Arquivo processado Image Removed Nota incluída (VGLMFISX) Image Removed Fiscal Mensal (VGLFFISC) – Seleção de mês Image Removed Seleção da nota Image Removed Nota Fiscai importada Image Removed Detalhe com os campos novos de Observações do Produto Image Removed Totvs custom tabs box items default noyes referencia passo4 Totvs custom tabs box items default no referencia passo5 Totvs custom tabs box items default no referencia passo6 passo1 Adicionar Embalagem do Produto - POST Objetivo Método que permite inserir/atualizar as embalagens dos produtos. Podem ser enviadas várias embalagens, de compra ou de venda, para um mesmo produto, sendo exigido pelo menos uma de cada tipo. Chamada POST api/v1/importacao/produto/embalagem Informações para Requisição (Request Information) Parâmetros URI (URI Parameters) Não há. Parâmetros do Corpo (Body Parameters) Nome (Name) Descrição (Description) Tipo (Type) Informações Adicionais (Adittional Information) SEQPRODUTO* Código sequencial do produto. integer NROEMPRESA* Número da empresa ou código do depositante (quando utilizado Operador Logístico). integer Valor Máximo: 999 QTDEMBALAGEM* Quantidade de unidades dentro de cada embalagem. decimal (8,3) Valor Máximo: 99999,999 EMBALAGEM* Descrição da embalagem. Exemplo UN, CX, LT, etc. string Tamanho Máximo: 3 STATUSEMBALAGEM* Status da embalagem: A – Ativo I – Inativo. string Tamanho Máximo: 1 INDMIUDEZAGRANDEZA Indica se a embalagem do produto corresponde à: M – Miudeza G – Grandeza. string Tamanho Máximo: 1 PESOBRUTO** Peso bruto na embalagem do produto. Unidade de medida: quilo (kg).  decimal (7,3) Valor Máximo: 9999,999 PESOLIQUIDO** Peso líquido na embalagem do produto. Unidade de medida: quilo (kg).  decimal (7,3) Valor Máximo: 9999,999 ALTURA** Altura na embalagem do produto. Unidade de medida: centímetro (cm). decimal (9,6) Valor Máximo: 999,999999 LARGURA** Largura na embalagem do produto. Unidade de medida: centímetro (cm).  decimal (9,6) Valor Máximo: 999,999999 PROFUNDIDADE** Profundidade na embalagem do produto. Unidade de medida: centímetro (cm).  decimal (9,6) Valor Máximo: 999,999999 INDEMBALADO Indica se a embalagem do produto corresponde o tipo embalado: N – Não S – Sim. string Tamanho Máximo: 1 CODTARA Código da tara na embalagem do produto. A tara deve estar previamente cadastrada no WMS Parâmetros → Produtos → Tara Balança. string Tamanho Máximo: 10 PESOMEDIO Peso médio da embalagem do produto. Unidade de medida: quilo (kg). Utilizada na tolerância de separação. decimal (7,3) Valor Máximo: 9999,999 INDPADRAOEMBCOMPRA Indica se a embalagem é padrão de compra: N – Não  S – Sim. Obs. Na importação da primeira embalagem do produto ela será considerada padrão de compra independente do valor passado e quando vier uma nova embalagem setada como padrão de compra, esta nova será considerada e a anterior deixará de ser padrão. string Tamanho Máximo: 1 INDPADRAOEMBVENDA Indica se a embalagem é padrão de venda: N – Não S – Sim. Obs. Na importação da primeira embalagem do produto ela será considerada padrão de venda independente do valor passado e quando vier uma nova embalagem setada como padrão de venda, esta nova será considerada e a anterior deixará de ser padrão. string Tamanho Máximo: 1 *Campos Obrigatórios **Campos Obrigatórios caso o parâmetro dinâmico CRITICA_PRODUTO_INFO_FISICA tenha o valor "S - Sim". Pode ser verificado em: WMS Parâmetros → Parâmetro → Dinâmico. Validações Logísticas As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação da embalagem, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário.  O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada; A Empresa (NroEmpresa) deverá estar cadastrada previamente no Cadastro de Depositantes (WMS Parâmetros → Cadastro → Depositante); O Códiga da Tara (CodTara), quando informado, deverá estar cadastrado previamente no Cadastro de Tara Balança (WMS Parâmetros → Cadastro → Produtos → Tara Balança). ***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática. Formatos de Request (Request Formats) application/json, text/json Bloco de código language actionscript3 [ { "seqProduto": 1, "nroEmpresa": 1, "qtdEmbalagem": 1, "embalagem": "UN", "statusEmbalagem": "A", "indMiudezaGrandeza": "M", "indEmbalado": "S", "codTara": "1", "pesoBruto": 1.5, "pesoLiquido": 1.25, "altura": 50.12, "largura": 25.0, "profundidade": 25.0, "pesoMedio": 1.5, "indPadraoEmbCompra": "S", "indPadraoEmbVenda": "N" } ] Informações para Resposta (Response Information) Códigos do Recurso (Response Codes) OK (201) BadRequest (400) Totvs custom tabs box items default no referencia passo7 passo2 Adicionar Código de Barras do Produto - POST Objetivo Método que permite inserir/atualizar os códigos de barras dos produtos (códigos DUN, EAN, Internos ou Transição).  Chamada POST api/v1/importacao/produto/codigobarras Informações para Requisição (Request Information) Parâmetros URI (URI Parameters) Não há. Parâmetros do Corpo (Body Parameters) Nome (Name) Descrição (Description) Tipo (Type) Informações Adicionais (Adittional Information) SEQPRODUTO* Código sequencial do produto. integer NROEMPRESA* Número da empresa ou código do depositante (quando utilizado Operador Logístico). integer Valor Máximo: 999 QTDEMBALAGEM* Quantidade de unidades dentro de cada embalagem. decimal (8,3) Valor Máximo: 99999,999 CODACESSO* Código de barras do produto, podendo ser EAN8, EAN13, UCC12, DUN14 ou código de barras próprio definido internamente pela empresa. string Tamanho Máximo: 20 TIPCODIGO* Tipo do código do produto: E – Código de barras de unidade de consumo (EAN/UCC) D – Código de barras de unidade de despacho (DUN) I – Transição B – Código interno do produto string Tamanho Máximo: 1 *Campos Obrigatórios Validações Logísticas As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação do código de barras, o critério listado abaixo deve ser atendido. Caso contrário, será gerada uma crítica logística**, e o registro ficará pendente de verificação por um usuário.  A quantidade da embalagem (QTDEMBALAGEM) deverá estar previamente cadastrada para o Produto (SeqProduto) informado.  **As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática. Formatos de Request(Request Formats) application/json, text/json Bloco de código language actionscript3 [ { "seqProduto": 1, "nroEmpresa": 1, "qtdEmbalagem": 1.0, "codAcesso": "1234567890", "tipCodigo": "B" } ] Informações para Resposta (Response Information) Códigos do Recurso (Response Codes) OK (201) BadRequest (400) Totvs custom tabs box items default no referencia passo3 Adicionar Espécie de Endereço do Produto - POST Objetivo Método que permite inserir/atualizar as espécies de endereços dos produtos, incluindo os dados de norma de paletização, estoque mínimo para reposição, etc. Não é obrigatório o envio dessa informação, e quando não é enviada, a mesma pode ser cadastrada diretamente no módulo WMS Centro de Distribuição. Chamada POST api/v1/importacao/produto/especieendereco Informações para Requisição (Request Information) Parâmetros URI (URI Parameters) Não há. Parâmetros do Corpo (Body Parameters) Nome (Name) Descrição (Description) Tipo (Type) Informações Adicionais (Adittional Information) SEQPRODUTO* Código sequencial do produto. integer NROEMPRESA* Número da empresa ou código do depositante (quando utilizado Operador Logístico). integer Valor Máximo: 999 QTDEMBALAGEM* Quantidade de unidades dentro de cada embalagem. decimal (8,3) Valor Máximo: 99999,999 ESPECIEENDERECO* Espécie de endereço previamente cadastrada em WMS Parâmetros → Cadastro → Endereços → Espécie de Endereços. string Tamanho Máximo: 1 PALETELASTRO* Quantidade do lastro da norma. integer Tamanho Máximo: 99999 PALETEALTURA* Quantidade da altura da norma. integer Tamanho Máximo: 99999 ESTQMINIMOREP Quantidade de estoque mínimo da espécie de endereço do produto para que seja iniciado o processo de reposição. decimal (12,3) Valor Máximo: 999999999,999 *Campos Obrigatórios Validações Logísticas As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação da espécie de endereço, os critérios listados abaixo devem ser atendidos. Caso contrário, será gerada uma crítica logística**, e o registro ficará pendente de verificação por um usuário.  O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada; A Embalagem (QtdEmbalagem) deverá estar cadastrada previamente para o produto (SeqProduto) e empresa (NroEmpresa) informada; A Espécie de Endereco (EspecieEndereco) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada. **As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática. Formatos de Request(Request Formats) application/json, text/json Bloco de código language actionscript3 [ { "seqProduto": 1, "nroEmpresa": 1, "qtdEmbalagem": 12, "especieEndereco": "A", "paleteLastro": 10, "paleteAltura": 1, "estqMinimoRep": 10 } ] Informações para Resposta (Response Information) Códigos do Recurso (Response Codes) OK (201) BadRequest (400) Totvs custom tabs box items default no referencia passo4 Adicionar Categorias dos Produtos - POST Objetivo Método que permite inserir/atualizar os dados de associação das categorias aos produtos. Chamada POST /api/v1/importacao/produto/categoriaproduto Informações para Requisição (Request Information) Parâmetros URI (URI Parameters) Não há. Parâmetros do Corpo (Body Parameters) Nome (Name) Descrição (Description) Tipo (Type) Informações Adicionais (Adittional Information) SEQPRODUTO* Código sequencial do Produto. integer NRODIVISAO* Número da divisão da empresa ( Quando o ERP não utiliza deste recurso passar ZERO ). integer Valor Máximo: 999 NROEMPRESA* Código da empresa do Produto. integer Valor Máximo: 999 SEQCATEGORIA* Código Sequencial da Categoria em que o produto está vinculado. Somente pode vincular uma categoria que estiver com MAXHIERARQUIA = 'S'. integer Valor Máximo: 99999 *Campos Obrigatórios Validações Logísticas As validações logísticas, não impactam no retorno da requisição. Entretanto, para a correta importação de associação das categorias aos produtos, o critério listado abaixo deve ser atendido. Caso contrário, será gerada uma crítica logística***, e o registro ficará pendente de verificação por um usuário.  O produto (SeqProduto) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.    ***As críticas logísticas podem ser visualizadas através da aplicação: WMS Centro de Distribuição -> Gerencial -> Consultas -> Exclusão de Rejeições da Importação Automática. Formatos de Request (Request Formats) application/json, text/json Bloco de código language actionscript3 { "seqProduto": 407640, "nroEmpresa": 100, "nroDivisao": 1, "seqCategoria": 102 } Informações para Resposta (Response Information) Códigos do Recurso (Response Codes) OK (201) BadRequest (400) Importação de Notas (WS) Leiaute de importação FIS0001 Tabelas de Integração de Movimentos Fiscais VGLIMPFS Tratamento dos campos: Campos novos na tabela AW1IMPNC: IMPNC_FST_DFD_BAS - Base de Cálculo do FECOP-ST DIFAL Destino IMPNC_FST_DFD_VAL - Valor do FECOP-ST DIFAL Destino IMPNC_IST_DFD_BAS - Base de Cálculo do ICMS ST DIFAL Destino IMPNC_IST_DFD_VAL - Valor do ICMS ST DIFAL Destino IMPNC_FCP_DFD_BAS - Base de Cálculo do FECOP DIFAL Destino IMPNC_FCP_DFD_VAL - Valor do FECOP DIFAL Destino Campos novos na tabela AW1IMPNI: IMPNI_FST_DFD_BAS - Base de Cálculo do FECOP-ST DIFAL Destino IMPNI_FST_DFD_VAL - Valor do FECOP-ST DIFAL Destino IMPNI_FST_DFD_ALQ - Alíquota do FECOP-ST DIFAL Destino IMPNI_IST_DFD_BAS - Base de Cálculo do ICMS ST DIFAL Destino IMPNI_IST_DFD_VAL - Valor do ICMS ST DIFAL Destino IMPNI_IST_DFD_ALQ - Alíquota do ICMS ST DIFAL Destino IMPNI_FCP_DFD_BAS - Base de Cálculo do FECOP DIFAL Destino IMPNI_FCP_DFD_VAL - Valor do FECOP DIFAL Destino IMPNI_FCP_DFD_ALQ - Alíquota do FECOP DIFAL Destino IMPNI_EAN_COM_XML - EAN da Unidade Comercial do XML IMPNI_UNI_COM_XML - Unidade Comercial do XML IMPNI_QTD_COM_XML - Quantidade Comercial do XML IMPNI_EAN_TRB_XML - EAN da Unidade Tributável do XML IMPNI_UNI_TRB_XML - Unidade Tributável do XML IMPNI_QTD_TRB_XML - Quantidade Trib do XML IMPNI_IDE_FIS - Identificação do campo de Observação do Fisco IMPNI_OBS_FIS - Observação do Fisco IMPNI_IDE_CTR - Identificação do campo de Observação do Contribuinte IMPNI_OBS_CTR - Observação do Contribuinte Criação da tabela FIS_LOTE_ITEM_IMP IMPLT_ID - Identificador da NF IMPLT_SEQ_ITE - Sequencial do Item IMPLT_SEQ_LOT - Sequencial do Lote IMPLT_COD_LOT - Número do lote IMPLT_QTD_LOT - Quantidade do lote IMPLT_VLD_LOT - Data de validade do lote (DDMMAAAA) IMPLT_FAB_LOT - Data de fabricação do lote (DDMMAAAA) IMPLT_CLA_LOT - Classificação do lote IMPLT_AGR_LOT - Código de agregação do lote Importação de XML nos web services SOCIN / TES Na tela Inicial, seleciona “Importação Manual Unitária” Image Removed Seleciona o arquivo XML para importação Image Removed Nota importada com sucesso Image Removed Consulta no Registro Fiscal da nota incluída (VGLMFISX) Image Removed Consulta detalhes da nota importada no Registro Fiscal (VGLMFISX) Image Removed Fiscal Mensal (VGLFFISC) – Seleção de mês Image Removed Seleção da nota Image Removed Nota Fiscal importada Image Removed Detalhe com os campos novos de Observações do Produto Image Removed Detalhe com os Lotes do Produto Image Removed Conector NF-e Seguindo a NT2021.004 se faz necessário a inclusão da tag obsItem e seus filhos e atributos. No momento da importação de notas pelo conector, o mesmo verifica se possui tal conteúdo e agrega-os. O mesmo vale para geração do XML. Figura 1 - abaixo mostra o resultado: Image Removed Além das adequações da NT2021.004 com relação ao obsItem, temos uma situação que, ao cliente fazer muitas consultas à SEFAZ num curto intervalo de tempo, estava sobrecarregando tal serviço. Com isso, a SEFAZ limitou o acesso com penalidade de multa. Para que isso não aconteça, criamos um tratamento para que, ao consultar os XML na SEFAZ, o mesmo seja apenas 1 (hum) no intervalo de 1h (Uma hora). É realizada uma primeira consulta e gravamos o horário desta consulta para que a partir dela dentro de 60 minutos não haja uma nova; Caso haja tal consulta, nosso tratamento bloqueia o acesso e tal informação está disponível no log da aplicação. Quando o serviço for buscar a autorização para fazer consulta à SEFAZ e esta autorização for concedida, será gravado na tabela DFE_CONTROLE seus dados e o horário desta autorização para que, durante 60 minutos, não seja permitida uma nova consulta. Figura 2 - Tabela dfe_controle Image Removed Figura 3 - Havendo uma nova solicitação de autorização de consulta dentro de 60 minutos da consulta anterior, haverá o bloqueio e informado no log da aplicação que não está disponível no momento. No banco de dados, o avanço de tempo é em decimal. Image Removed Parametrização Exclusão das informações de transportador Os testes da NF-e demonstraram que a NF-e é criticada pela SEFAZ quando existe a mesma raiz de CNPJ do emitente e do destinatário no grupo de <transporta> e a modalidade do frete é 3-Transporte próprio por conta do remetente ou 4-Transporte próprio por conta do destinatário. A regra da NF-e que não está sendo tratada de forma coerente é: Image Removed Para esta situação, que normalmente ocorre com transferências foi criado um parâmetro para excluir as informações do grupo <transporta> e a nota ser autorizada pela SEFAZ. Parâmetro (AA2CPARA): Código: 30 Acesso: EXTRTRANSP Conteúdo: S Totvs custom tabs box items default no referencia passo8 Totvs custom tabs box items default no referencia passo9

POST /api/v1/importacao/produto/componenteprodutocomposto

[
  {
  	"seqProdFinal": 120612,
  	"seqProdComponente": 12987,
  	"nroEmpresa": 100,
  	"qtdEmbalagem": 1,
  	"quantidade": 15
  }
]