Guia de Uso da NFe_Util 2Gv0.9

Guia de Uso » Gerar XML da NF-e » Item da NF-e » Dados do Produto » Detalhe dos Produtos e Serviços 2G

16.7.1. Dados do Produto
16.7.1.2. Detalhe dos Produtos e Serviços 2G

16.7.1.1. Detalhe dos Produtos e Serviços
« Anterior

16.7.1.3. Informações da DI
Próximo »

16.7.1.2. Detalhe dos Produtos e Serviços 2G

Funcionalidade para gerar o XML do grupo do detalhamento de produtos e Serviços da NF-e 2G

Assinatura

string produto2G(string cProd, string cEAN, string xProd, string NCM, string EXTIPI, int CFOP, string uCom, double qCom, double vUnCom, double vProd, string cEANTrib, string uTrib, double qTrib, double vUnTrib, double vFrete, double vSeg,double vDesc, double vOutro, int indTot, string DI, string DetEspecifico, string xPed, int nItemPed);

Descrição:

Funcionalidade para gerar o XML do grupo do detalhamento de produtos e Serviços da NF-e na versão 2.00 do leiaute da NF-e.

Parâmetros:

nome	tipo	tam.	obrig.	descrição
cProd	string	1-60	sim	informar o código do produto ou serviço. Preencher com CFOP, caso se trate de itens não relacionados com mercadorias/produtos e que o contribuinte não possua codificação própria. Formato ”CFOP9999”.
cEAN	string	0,8,12,13,14	sim	informar o GTIN (Global Trade Item Number) do produto, antigo código EAN ou código de barras. Preencher com o código GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 (antigos códigos EAN, UPC e DUN-14), não informar o conteúdo da TAG em caso de o produto não possuir este código.
xProd	string	1-120	sim	informar a descrição do produto ou serviço.
NCM	string	2,8	não	informar o Código NCM com 8 dígitos; informar a posição do capítulo do NCM (as duas primeiras posições do NCM) quando a operação não for de comércio exterior (importação/ exportação) ou o produto não seja tributado pelo IPI; se for serviços, informar 00. (campo alterado para ser obrigatório)
EXTIPI	string	2,3	não	informar de acordo com o código EX da TIPI se houver para o NCM do produto.
CFOP	inteiro	4	sim	informar o CFOP - Código Fiscal de Operações e Prestações.
uCOM	string	1-6	sim	informar a unidade de comercialização do produto (Ex. pc, und, dz, kg, etc.).
qCOM	string	15,4	sim	informar a quantidade de comercialização do produto já formatado com ponto decimal. A quantidade de casas decimais pode variar de 0 a 4. (tamanho e tipo do campo alterado)
vUnCOM	string	21,10	sim	Informar o valor unitário de comercialização do produto já formatado com ponto decimal, campo meramente informativo, o contribuinte pode utilizar a precisão desejada (0-10 decimais). Para efeitos de cálculo, o valor unitário será obtido pela divisão do valor do produto pela quantidade comercial. (tamanho e tipo do campo alterado)
vProd	duplo	15,2	sim	informar o valor total bruto do produto ou serviços.
cEANTrib	string	0,8,12,13,14	sim	informar o GTIN (Global Trade Item Number) da unidade de tributação do produto, antigo código EAN ou código de barras. Preencher com o código GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 (antigos códigos EAN, UPC e DUN-14), não informar o conteúdo da TAG em caso de o produto não possuir este código.
uTrib	string	1-6	sim	informar a unidade de tributação do produto (Ex. pc, und, dz, kg, etc.).
qTrib	string	15,4	sim	informar a quantidade de tributação do produto já formatado com ponto decimal. A quantidade de casas decimais pode variar de 0 a 4. (tamanho e tipo do campo alterado)
vUnTrib	string	21,10	sim	Informar o valor unitário de tributação do produto já formatado com ponto decimal, campo meramente informativo, o contribuinte pode utilizar a precisão desejada (0-10 decimais). Para efeitos de cálculo, o valor unitário será obtido pela divisão do valor do produto pela quantidade tributável. (tamanho e tipo do campo alterado)
vFrete	duplo	15,2	não	informar o valor do Frete, o Frete deve ser rateado entre os itens de produto.
vSeg	duplo	15,2	não	informar o valor do Seguro, o Seguro deve ser rateado entre os itens de produto.
vDesc	duplo	15,2	não	informar o valor do desconto do item de produto ou serviço.
vOutro	duplo	15,2	não	informar o valor de outras despesas acessórias do item de produto ou serviço. (campo novo)
indTot	inteiro	-	sim	Este campo deverá ser preenchido com: 0 - o valor do item (vProd) não compõe o valor total da NF-e (vProd) 1 - o valor do item (vProd) compõe o valor total da NF-e. (campo novo)
DI	string	-	não	informar o XML do grupo DI - dados da importação nas operações de importação.
DetEspecifico	string	-	não	informar o XML do grupo veicProd - detalhamento de específico de veículos novos ou com o XML do grupo med - detalhamento de específico de medicamentos ou com o XML do grupo arma - detalhamento de específico de armamentos ou com o XML do grupo comb - detalhamento de específico de combustíveis e lubrificantes.
xPed	string	1-15	não	informar o número do pedido de compra, o campo é de livre uso do emissor. (campo novo)
nItemPed	inteiro	-	não	informar o número do item do pedido de compra, o campo é de livre uso do emissor. (campo novo)

Importante

Os tipos dos parâmetros: qCom, qTrib, vUnCom e vUnTrib foram alterados para string, pois a quantidade de casas decimais passou a ser variável. Para dar maior flexibilidade, o usuário já deve passar os valores com a quantidade de casas decimais que desejar para a DLL, vale observar que o ponto decimal deve ser o ponto decimal.

Diagrama:

Dica

Os campos com contorno tracejado podem ser omitidos se a operação não exigir a informação.

Os grupos XML veicProd (detalhamento específico de veículos novos), med (detalhamento específico de medicamentos e insumos), arma (detalhamento específico de armamentos) e comb (detahamento específico de combustíveis e lubrificantes) são grupos XML que devem ser gerados em separado e são mutuamente exclusivos. Apenas um deles deve ser informado no parâmetro DetEspecifico.

Retorno:

Um string com o grupo XML do detalhe do Produto ou Serviço

XML:

Exemplo de XML do produto simples

<prod>
        <cProd>00001</cProd>
        <cEAN/>
        <xProd>Agua Mineral</xProd>
        <NCM>25</NCM>
        <CFOP>5101</CFOP>
        <uCom>dz</uCom>
        <qCom>1000</qCom>
        <vUnCom>1</vUnCom>
        <vProd>1000.00</vProd>
        <cEANTrib/>
        <uTrib>und</uTrib>
        <qTrib>12000</qTrib>
        <vUnTrib>1</vUnTrib>
        <intTot>1</intTot>
</prod>

Exemplo de XML do produto com detalhamento específico de medicamento

 
<prod>
      <cProd>402729</cProd>
      <cEAN>7891058008628</cEAN>
      <xProd>DORFLEX 24X10 CP CH</xProd>
      <NCM>30049012</NCM>
      <genero>30</genero>
      <CFOP>5409</CFOP>
      <uCom>CX</uCom>
      <qCom>2</qCom>
      <vUnCom>25.4850</vUnCom>
      <vProd>50.97</vProd>
      <cEANTrib>7891058008628</cEANTrib>
      <uTrib>CX</uTrib>
      <qTrib>2</qTrib>
      <vUnTrib>25.4850</vUnTrib>
      <intTot>1</intTot>
      <med>
           <nLote>602958</nLote>
           <dVal>2008-05-01</dVal>
           <vPMC>80.73</vPMC>
      </med>
</prod>

Importante

O trecho do XML foi formatado para uma melhor visualização, a mensagem original não tem formatação.

Vale observar que a formatação pode corromper a assinatura digital, além de ocupar espaço e ser desnecessária, pois os browser exibem formatado.

Exemplos de uso:

Visual Basic 6.0

' inicializar variáveis
'...............................................

Dim objNFeUtil As NFe_Util_2G.Util
 
Set objNFeUtil = New NFe_Util_2G.Util
'
'
'================grupo de detalhe do produto (grupo I01 do Manual de integração - páginas 95)=======================
'
'
Prod_cProd = "001152"                       ' código do produto
Prod_cEAN = "7897844200115"                 ' código EAN (0, 8,12, 13 ou 14 caracteres), o conteúdo pode ser omitido se não tiver EAN
Prod_xProd = "Cola Especial para EPS"       ' código do produto, espaços em branco consecutivos ou no início ou fim do campo podem
                                            ' gerar erro de Schema XML, além de caracteres reservados do XML <>&"'
Prod_NCM = "35"                             ' código NCM, pode informar somente a posição do capítulo se a operação não for sujeito ao IPI.
Prod_ExTIPI = ""                            ' ExTipi, informar de acordo com o código EX da TIPI se houver para o NCM do produto.
Prod_CFOP = "5102"                          ' CFOP do operação, causa erro de XML se informado um código inexistente
Prod_uCOM = "UN"                            ' unidade de comercialização
Prod_qCom = "10"                            ' quantidade de comercialização
Prod_vUnCom = "1"                           ' valor unitário de comercialização, campo de mera demonstração deve ser o resultado da
                                            ' da divisão do vProd / qCom
Prod_vProd = 10                             ' valor do total do item
Prod_cEANTrib = "7897844200115"             ' código EAN (0, 8,12, 13 ou 14 caracteres), o conteúdo pode ser omitido se não tiver EAN,
                                            ' em geral é o mesmo código do EAN de comercialização
Prod_uTrib = "UN"                           ' unidade de tributação, na maioria dos casos é idêntico  ao vUnCom, pode diferente nos
                                            ' casos de produtos sujeitos a ST em que a unidade de pauta é diferente da unidade de
                                            ' comercialização
                                            ' Ex. unidade de comercialização = 1 pack de lata de cerveja => unidade de tributação = 
                                            ' 1 lata (preço de pauta)
Prod_qTrib = "10"                           ' quantidade de comercialização
Prod_vUnTrib = "1"                           ' valor unitário de tributação, campo de mera demonstração deve ser o resultado da
                                            ' divisão do vProd / qTrib
Prod_vFrete = 0                             ' valor do frete, se cobrado do cliente deve ser rateado entre os itens de produto
Prod_vSeguro = 0                            ' valor do seguro, se cobrado do cliente deve ser rateado entre os itens de produto
Prod_vDesc = 0                              ' valor do desconto concedido
Prod_vOutro = 0                             ' valor de outras despesas
Prod_indTot = 1                             ' indicador se o valor do item será totalizado no valor total dos produtos
Prod_DI = ""                                ' dados da importação, informar apenas no caso de NF de entrada (importação), para montar
                                            ' o grupo utilize a funcionalidade DI
Prod_DetEspecifico = ""                     ' dados específicos, informar para medicamento, veículos novos, armamentos e
                                            ' combustíveis, para montar o grupo utilizar a funcionalidade correspondente
Prod_xPed = ""                              ' número do pedido, uso exclusivo do usuário
Prod_nItemPed = 0                           ' número do item do pedido, uso exclusivo do usuário

'
'   gera grupo do produto
'
prod = objNFeUtil.produto2G(Prod_cProd, Prod_cEAN, Prod_xProd, Prod_NCM, Prod_ExTIPI, Prod_CFOP, Prod_uCOM, Prod_qCom, Prod_vUnCom, Prod_vProd, Prod_cEANTrib, Prod_uTrib, Prod_qTrib, Prod_vUnTrib, Prod_vFrete, Prod_vSeguro, Prod_vDesc, Prod_vOutro, Prod_indTot, Prod_DI, Prod_DetEspecifico, Prod_xPed, Prod_nItemPed)

Importante

Se houver mais de um item de detalhe, o usuário deve concatenar os detalhes.

16.7.1.2. Detalhe dos Produtos e Serviços 2G
16.7.1. Dados do Produto

« Anterior
16.7.1.1. Detalhe dos Produtos e Serviços

Próximo »
16.7.1.3. Informações da DI

Copyright © FlexDocs Documentos Eletrônicos - 2008-2012 - Todos os direitos reservados

Generated by TypeFriendly 0.1.3 by Invenzzia