Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Tempo aproximado para leitura: 10 min

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)

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).

integerValor Máximo: 999
SEQFORNECEDOR*

Código ou CNPJ do fornecedor. Vinculado ao campo TIPCODIGO.

integer
TIPCODIGO*Tipo do código do fornecedor:
I  – Código Interno(Padrão)
C – CNPJ.
stringTamanho Máximo: 1
CODTIPENDERECO

Código do tipo do endereço(normal, alto, baixo, etc.) previamente cadastrado no ACRUX LOCUS PARÂMETRO / Tipos de Endereços.

Caso esse campo não seja enviado, será considerado o valor padrão "N".

stringTamanho Máximo: 3
DESCCOMPLETA*Descrição completa do produto.stringTamanho Máximo: 70
DESCREDUZIDA*Descrição reduzida do produto.stringTamanho Máximo: 20
STATUSCOMPRA*Status de compra do produto:
A – Ativo
I  – Inativo.
stringTamanho Máximo: 1
STATUSVENDA*Status de venda do produto:
A – Ativo
I  – Inativo.
stringTamanho Máximo: 1
TIPARMAZENAGEM

Tipo de armazenagem do produto, previamente cadastrado no ACRUX LOCUS PARÂMETRO /  Atributo Fixo.

Caso esse campo não seja enviado, será considerado o valor padrão "N".

stringTamanho Máximo: 5
TIPSEPARACAO

Tipo de separação do produto, previamente cadastrado no ACRUX LOCUS PARÂMETRO /  Atributo Fixo.

Caso esse campo não seja enviado, será considerado o valor padrão "N".

stringTamanho Máximo: 1
PZOVALIDADEDIA*

Prazo de validade do produto a partir da data da fabricação(em dias).

Caso não utilize este conceito enviar "0".

integerValor Máximo: 9999
PESAVELIndica se o produto é pesável:
S  – Sim
N – Não.
stringTamanho Máximo: 1
ADVARMAZENAGEMAdvertência de Armazenagem. Mensagem que será mostrada no momento da armazenagem do produto.stringTamanho Máximo: 80
EMTETIQUETAIndicador de emissão de etiquetas de códigos de barra:
S  – Sim
N – Não.

Quando "S", emite as etiquetas que vão substituir códigos dos produtos que não possuem código de barras.

Caso esse campo não seja enviado, será considerado o valor padrão "S".

stringTamanho Máximo: 1
INDPROCFABRICACAO

Indica se é um produto de composição:
S – Sem processo de produção
B – Produto base para desmembramento
F – Produto final composto
V – Produto de composição variável
I  – Insumo para produção
C – Composto para separação.

Caso esse campo não seja enviado, será considerado o valor padrão "S".

stringTamanho Máximo: 1
MEDVDIAGERALMédia de venda geral por dia. Valor da média de venda geral do produto.

decimal (12,6)

Valor Máximo: 999999,999999
EXGNROLOTE

Indica se o produto exige que seja informado lote de fabricação:
S  – Sim
N – Não.

stringTamanho Máximo: 1
REFFABRICANTEDescrição da referência do produto enviada pelo fabricante.stringTamanho Máximo: 20
EXGNROSERIEIndica se o produto exige que seja informado o número da série na conferência:
S  – Sim
N – Não.
stringTamanho Máximo: 1
QTDTOLARMAZPRODQuantidade para tolerância na armazenagem.integerValor Máximo: 999999999
REFERENCIAReferência do produto que será concatenada na descrição completa do produto.stringTamanho Máximo: 20
UTZESTRUTDRIVEINIndica se o produto utiliza estrutura Drive-In:
S  – Sim
N – Não.
stringTamanho Máximo: 1
EXGCERTIFICADOIndica se o produto exige certificado:
S  – Sim
N – Não.
stringTamanho Máximo: 1
INDALTORISCOIndica se o produto é de alto risco:
S  – Sim
N – Não.

Parâmetro vinculado ao processo de Sorter.

stringTamanho Máximo: 1
INDEXGVALIDACAOMONTAGEMPALETEIndica se o produto exige validação na montagem do palete:
S  – Sim
N – Não.

Parâmetro vinculado ao processo de Sorter.

stringTamanho Máximo: 1
QTDVOLGERAETQMASTER

Quantidade de volumes para que seja gerada etiqueta master automaticamente, para que não passe pelo processo de montagem.

Parâmetro vinculado ao processo de Sorter.

integerValor Máximo: 999
SEQFAMILIACódigo sequencial da família do produto.integer
USUARIOALTERACAOUsuário que realizou a última alteração no cadastro do produto.stringTamanho Máximo: 12
INDCONTROLATEMPERATURAIndica se o produto controla temperatura:
S  – Sim
N – Não.

Parâmetro vinculado ao processo de conferência de recebimento.

stringTamanho Máximo: 1
INDCONTROLARASTREABILIDADEIndica se o produto controla rastreabilidade:
S  – Sim
N – Não.

Parâmetro vinculado ao processo de rastreabilidade.

stringTamanho Máximo: 1
QTDDIASCONTROLEQUARENTENA

Quantidade de dias para controle de rastreabilidade. Parâmetro vinculado ao processo de rastreabilidade. 

Obrigatório caso o campo INDCONTROLARASTREABILIDADE esteja marcado como "S".

integerValor Máximo: 999
SEQPRODUTOBASECódigo sequencial do produto base.integer

*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 Tipo de Endereço (CodTipEndereco) deverá estar cadastrado previamente no Cadastro de Tipos de Endereco (WMS Parâmetros → Cadastro → Endereço → Tipos de Endereços);
  2. O Tipo da Separação (TipSeparacao) deverá estar cadastrado previamente no Cadastro de Atributos Fixos, na opção Tipo de Atributo: Tipo de Separação (WMS Parâmetros → Cadastro → Atributos Fixos);
  3. 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);
  4. O Fornecedor (SeqFornecedor) deverá estar cadastrado previamente no sistema;
  5. O Produto Base (SeqProdutoBase) não poderá estar relacionado a outro produto;
  6. 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

Bloco de código
languageactionscript3
{
  "seqProduto": 11,
  "nroEmpresa": 100,  
  "seqFornecedor": 752,
  "tipCodigo": "I",
  "codTipEndereco": "N",
  "descCompleta": "Teste descriçao completa",
  "descReduzida": "Teste reduzida",
  "statusCompra": "A",
  "statusVenda": "A",  
  "tipArmazenagem": "N",
  "tipSeparacao": "N",
  "pzoValidadeDia": 100,
  "pesavel": "N",
  "emtEtiqueta": "N",
  "indProcFabricacao": "S",
  "medVDiaGeral": 1500.000000,
  "ExgNroLote" : "N",
  "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" : "S",
  "QtdDiasControleQuarentena" : 1,
  "UsuarioAlteracao" : "CONSINCO"
}

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

  • OK (201)
  • BadRequest (400)


*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

Totvs custom tabs box
tabsEmbalagem do Produto, Código de Barras do Produto, Espécie de Endereço do Produto, Categorias dos Produtos, Componentes do Produto Composto
idspasso1,passo2,passo3,passo4,passo5
integer
Totvs custom tabs box items
defaultyes
referenciapasso1

Adicionar Embalagem do Produto - POST

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 Compostoas 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/componenteprodutocompostoembalagem

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)
SEQPRODFINAL
SEQPRODUTO*

Código sequencial do produto

final que é gerado após a finalização da composição.

.

integer
integerSEQPRODCOMPONENTE*

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


NROEMPRESA*

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

integerValor Máximo: 999
QTDEMBALAGEM*

Quantidade de unidades dentro de cada embalagem

do produto componente na composição do produto final acabado

.

integer
decimal (8,3)Valor Máximo:
999999999999
99999,
999999
999
QUANTIDADE*Quantidade utilizada do produto componente na composição do produto final acabado.integerValor Máximo: 999999999999,999
EMBALAGEM*Descrição da embalagem. Exemplo UN, CX, LT, etc.stringTamanho Máximo: 3
STATUSEMBALAGEM*Status da embalagem:
A – Ativo
I – Inativo.
stringTamanho Máximo: 1
INDMIUDEZAGRANDEZAIndica se a embalagem do produto corresponde à:
M – Miudeza
G – Grandeza.
stringTamanho 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
INDEMBALADOIndica se a embalagem do produto corresponde o tipo embalado:
N – Não
S – Sim.
stringTamanho Máximo: 1
CODTARACódigo da tara na embalagem do produto. A tara deve estar previamente cadastrada no WMS Parâmetros → Produtos → Tara Balança.stringTamanho Máximo: 10
PESOMEDIOPeso 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.

stringTamanho 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.

stringTamanho 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. 

  1. O Produto (SeqProduto) deverá estar cadastrada previamente para a empresa (NroEmpresa) informada;
  2. A Empresa (NroEmpresa) deverá estar cadastrada previamente no Cadastro de Depositantes (WMS Parâmetros → Cadastro → Depositante);
  3. 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
languageactionscript3
[
  {
  	"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" 
Bloco de código
languageactionscript3
[
  {
  	"seqProdFinal": 120612,
  	"seqProdComponente": 12987,
  	"nroEmpresa": 100,
  	"qtdEmbalagem": 1,
  	"quantidade": 15
  }
]

Informações para Resposta Resposta (Response Information)

Códigos do Recurso (Response Codes)

  • OK (201)
  • BadRequest (400)
Totvs custom tabs box items
defaultno
referenciapasso2

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)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
SEQPRODFINAL*

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

integer


SEQPRODCOMPONENTE*

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

integer
NROEMPRESA*

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

integerValor Máximo: 999
QTDEMBALAGEM*Quantidade de unidades dentro de cada embalagem do produto componente na composição do produto final acabado.integerValor Máximo: 999999999999,999999
QUANTIDADE*Quantidade utilizada do produto componente na composição do produto final acabado.integerValor Máximo: 999999999999,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 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

Bloco de código
languageactionscript3
[
  {
  	"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)
Totvs custom tabs box items
defaultno
referenciapasso3

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:

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

Totvs custom tabs box items
defaultno
referenciapasso4

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


Executando o programa de NFC-e – VGTUNFCE


Mensagem da conversão


Conversão efetuada

Registro da NFC-e - Seleção


Consulta da NFC-e


Campos novos adicionados ao registro


Tabela alterada

Totvs custom tabs box items
defaultno
referenciapasso5

Adicionar Componentes do Produto Composto - POST

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)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
SEQPRODFINAL*

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

integer


SEQPRODCOMPONENTE*

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

integer
NROEMPRESA*

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

integerValor Máximo: 999
QTDEMBALAGEM*Quantidade de unidades dentro de cada embalagem do produto componente na composição do produto final acabado.integerValor Máximo: 999999999999,999999
QUANTIDADE*Quantidade utilizada do produto componente na composição do produto final acabado.integerValor Máximo: 999999999999,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 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

Bloco de código
languageactionscript3
[
  {
  	"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)