Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Adicionar Embalagem do Produto - POSTObjetivoMé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. ChamadaPOST 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ísticasAs 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 |
---|
| [
{
"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) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Adicionar Código de Barras do Produto - POSTObjetivoMé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.códigos de barras dos produtos (códigos DUN, EAN, Internos ou Transição). ChamadaPOST /api/v1/importacao/produto/componenteprodutocompostocodigobarras 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) | SEQPRODFINALSEQPRODUTO* | Código sequencial do produto | final que é gerado após a finalização da composiçãoSEQPRODCOMPONENTE* | 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 |
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 | do produto componente na composição do produto final acabado.integer | Valor Máximo: 999999999999,999999 | QUANTIDADE* | . | 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 |
Quantidade utilizada do produto componente na composição do produto final acabado. | integer | Valor Máximo: 999999999999,999*Campos Obrigatórios Validações LogísticasO produto componente (SeqProdComponente) deverá estar cadastrado previamente na empresa (NroEmpresa) informadaAs 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 atendidoscó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. O produto final (SeqProdFinal) deverá estar cadastrado previamente na empresa (NroEmpresa) informada. o registro ficará pendente de verificação por um usuário. - A quantidade da embalagem (QtdEmbalagemQTDEMBALAGEM) deverá estar previamente cadastrada previamente para o SeqProdComponente 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 |
---|
| [
{
"seqProdFinalseqProduto": 1206121,
"seqProdComponentenroEmpresa": 129871,
"nroEmpresaqtdEmbalagem": 1001.0,
"qtdEmbalagemcodAcesso": 1"1234567890",
"quantidadetipCodigo": 15"B"
}
] |
Informações para Resposta Resposta (Response Information)Códigos do Recurso (Response Codes) |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| 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 |
---|
default | no |
---|
referencia | passo4 |
---|
| 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 |
---|
default | no |
---|
referencia | passo5 |
---|
| Adicionar Componentes do Produto Composto - POSTObjetivoMé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. ChamadaPOST /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). | integer | Valor Máximo: 999 | QTDEMBALAGEM* | Quantidade de unidades dentro de cada embalagem do produto componente na composição do produto final acabado. | integer | Valor Máximo: 999999999999,999999 | QUANTIDADE* | Quantidade utilizada do produto componente na composição do produto final acabado. | integer | Valor Máximo: 999999999999,999 |
*Campos Obrigatórios Validações LogísticasAs 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. - O produto final (SeqProdFinal) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.
- O produto componente (SeqProdComponente) deverá estar cadastrado previamente na empresa (NroEmpresa) informada.
- 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 |
---|
| [
{
"seqProdFinal": 120612,
"seqProdComponente": 12987,
"nroEmpresa": 100,
"qtdEmbalagem": 1,
"quantidade": 15
}
] |
Informações para Resposta (Response Information)Códigos do Recurso (Response Codes) |
|