Manual de Integração com o WebService Tributário

Versão: 1.13 – 28/02/2019

Manual de Integração com o WebService Tributário

O WebService funciona via protocolo SOAP, HTTP GET e HTTP POST. Para mais detalhes técnicos sobre o serviço consulte
a documentação em http://consultatributos.com.br:8888/wsGeral.asmx?WSDL

Endereço do serviço:
http://consultatributos.com.br:8888/wsGeral.asmx
Nome do método a ser utilizado: MetodoConsultaProdutoXML
Parâmetro do método: XML (conforme layout descrito abaixo)

Layout do XML de Envio:

TAG Raiz: EnvioDados

TAG: Cabecalho

# Campo Descrição Tipo Tam. Observação Obrig.

1 CNPJ CNPJ da empresa C 14 Sim
2 UF UF da empresa C 2 Sim
3 CRT Código de regime N 1 1=Simples Nacional; Sim
tributário da empresa, 2=Simples Nacional, excesso
conforme NFe sublimite de receita bruta;
3=Regime Normal. (v2.0).
4 CNAE Código CNAE Principal C 7 Somente números. Não
da empresa Exemplo: CNAE 82.19-9.99 =>
8219999
5 regimeEspecial Regime Especial C S=Sim (Restaurantes 3,20%) Não
A=Sim (Açougues 4,00%)*
SP62843 = (Carnes 4,50%)*
N=Não
(*) Exclusivo para SP
6 codFaixa Código da faixa de N 2-3 Código da faixa conforme ANEXO I Não
enquadramento
7 tpConsulta Tipo de consulta N 1 1=Envio de Produtos em modo Sim
homologação;
2=Envio de produtos em modo
produção.
8 versao Versão do XML C 1-4 Fixo “2.0” Sim
9 assinatura Assinatura do XML C 0- O conteúdo desse campo será Não
128 fornecido pela IMendes e será
único e exclusivo para cada
Parceiro.

Grupo IMendes - Manual de Integração com o WebService Tributário - 1

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

TAG: Produto
# Campo Descrição Tipo Tam. Observação Obrig.
1 ID Sequencial N Sim
2 EAN Código de barras do N 8-14 Se produto não possuir EAN, Não
produto informe vazio
3 codigoInterno Código interno do produto C 0-20 Não
4 codigoIMendes Código único IMendes N 1-10 Código disponibilizado pela Não
IMendes para fazer associação
junto ao cadastro do cliente
5 descricao Descrição do produto C 1-60 Sim
6 refeicao Indica se produto é refeição C 1 S=Sim Não
N=Não

7 vVenda Valor de venda do produto N 13v2 Valor de venda total do produto Não
no período indicado no período desejado, para que
seja feita simulação do valor do
DAS.
8 CSTCSOSN CST / CSOSN do produto N 3 CST ou CSOSN, dependendo do Não
regime da empresa.
9 pICMS Alíquota de ICMS do N 2v2-4 Não
produto
10 pRedBCICMS Redução da base de cálculo N 2v2-4 Não
do ICMS do produto
11 pRedBCICMSST Redução da base de cálculo N 2v2-4 Não
do ICMS ST do produto
12 pMVAST IVA do produto N 2v2-4 Não
13 vPautaST Valor de pauta do produto N 13v2 Não
14 NCM NCM do produto C 0-8 Não
15 pIPI Alíquota de IPI N 3v2-4 Não
16 CSTPISCOFINSEntrada CST PIS/COFINS de entrada N 2 Não
do produto
17 CSTPISCOFINSSaida CST PIS/COFINS de saída do N 2 Não
produto
18 naturezaReceitaIsentaPISCOFINS Código da natureza de N 0-3 Não
receita isenta de
PIS/COFINS do produto
19 CEST Código da S.T C 0-9 Não
20 pFCP Alíquota de ICMS FCP do N 2v2-4 Percentual de FCP Não
produto (Fundo de Combate à Pobreza)

Grupo IMendes - Manual de Integração com o WebService Tributário - 2

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

A TAG Cabeçalho deve ser referenciada apenas uma vez por arquivo XML.
A TAG Produto deve ser criada de acordo com a quantidade de produtos referenciados, porém vale salientar que é
extremamente recomendável quebrar em mais de um arquivo quando o cadastro de produtos a ser analisado conter
muitos registros.
Recomenda-se no máximo 1 mil produtos por XML (sendo esse o limite), deve ser observado nessa condição a
infraestrutura de internet do cliente, em casos onde a comunicação é lenta esse número pode ser ainda menor para obter
um melhor aproveitamento.
Somente é aceito arquivo com no máximo 3 megabytes.
Recomendação de configuração de Timeout entre 3(três) e 5(cinco) minutos.
Observações: A TAG “tpConsulta” deve-se ter muita atenção, pois quando seu valor é enviado como “1” o WebService
não coloca em analise os produtos não encontrados, ou seja, aqueles produtos que devem ser analisados e classificados
pela equipe de consultores, nesse caso esse procedimento não irá acontecer.
Porém, quando o parceiro ou cliente estiver em homologação não deve ser enviado sendo como “2”.

ATENÇÃO
Parceiros/Clientes que estão em Homologação irão receber dados fictícios, ou seja, para que os dados retornados por
nosso serviço sejam reais, será necessário estar em Produção.

Obrigatoriamente campos como valores ou percentuais devem usar separador decimal sendo ponto “.” e nunca devem
ter separador de milhar.

Grupo IMendes - Manual de Integração com o WebService Tributário - 3

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

Layout do XML de Retorno:

TAG Raiz: Integracao

TAG: Cabecalho

# Campo Descrição Tipo Tam. Observação

1 CNPJ CNPJ da empresa C 14
2 dataHora Data e Hora do retorno D Formato: “AAAA-MM-DDThh:mm:ss”
do XML
3 produtosEnviados Número de produtos N
enviados para o
WebService
4 produtosRetornados Número de produtos N
retornados pelo
WebService
5 produtosPendentes_Interno Número de produtos N
pendentes com código
interno
6 produtosPendentes_EAN Número de produtos N
pendentes com código
de barras
7 produtosPendentes_dataInicio Data mais antiga de um D
produto pendente
8 Transacao Número de transação N
do WebService
9 Mensagem Mensagem de retorno C 0-255 Mensagens que o servidor poderá
do WebService enviar ao cliente.

Grupo IMendes - Manual de Integração com o WebService Tributário - 4

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

TAG: Produto
# Campo Descrição Tipo Tam. Observação
1 ID Sequencial N
2 EAN Código de barras N 8-14
3 codigoInterno Código interno C 0-20
4 codigoIMendes Código único IMendes N 1-10 ID do produto na base de dados da
IMendes
5 CFOPCompra CFOP para Compra N 4
6 CFOPVenda CFOP para Venda N 4
7 CST CST ICMS N 3 Dependendo do regime da empresa
esse campo será vazio.
8 CSOSN CSOSN N 3 Dependendo do regime da empresa
esse campo será vazio.
9 modBC Modalidade de N 1 0=Margem Valor Agregado (%);
determinação da BC do 1=Pauta (Valor), 2=Preço Tabelado
ICMS Máx. (valor), 3=Valor da operação.
10 pICMS Alíquota de ICMS N 2v2-4 Se o percentual do Fundo de Combate à
Pobreza (pFCP) for maior que 0(zero), o
percentual do ICMS informado já será
acrescido do percentual do Fundo de
Combate à Pobreza.

Ex: (%) pICMS = 18 e (%) pFCP = 2

Então, o pICMS retornado pela IMendes
será de "20.00" (vinte por cento):
pICMS = ( pICMS + pFCP )
11 pICMSPDV Alíquota do ICMS para N 2v2-4
PDV
12 simbPDV Simbologia do ICMS C 1 T=Tributado, N=Não Tributado,
para PDV I=Isento, F=Subst. Tributária
13 pRedBCICMS Redução da base de N 2v2-4
cálculo do ICMS
14 pRedBCICMSST Redução da Base de N 2v2-4
Cálculo do ICMS ST
15 modBCST Modalidade de N 0-1 Modalidade de determinação da
determinação da BC do Base de Cálculo do ICMS (Para
ICMS ST Tributação do ICMS pelo SIMPLES
NACIONAL e CSOSN=202 ou 203).
Variação:
0 = Preço tabelado ou máximo
sugerido,
1 = Lista Negativa (valor),
2 = Lista Positiva (valor),
3 = Lista Neutra (valor),
4 = Margem Valor Agregado (%),
5 = Pauta (valor)
16 pICMSST Alíquota do ICMS ST N 2v2-4
17 pMVAST IVA N 2v2-4
18 vPautaST Valor de pauta N 13v2
19 NCM NCM C 0-8
20 pIPI Alíquota de IPI N 3v2-4

Grupo IMendes - Manual de Integração com o WebService Tributário - 5

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

21 CSTIPI CST do IPI N 2

22 CSTPISCOFINSEntrada CST PIS/COFINS de N 2
entrada
23 CSTPISCOFINSSaida CST PIS/COFINS de saída N 2
24 naturezaReceitaIsentaPISCOFINS Código da natureza de N 0-3
receita isenta de
PIS/COFINS
25 CEST Código da Substituição C 0-9
Tributária
26 pFCP Alíquota de ICMS FCP do N 2v2-4 Alíquota de ICMS FCP
produto (Fundo de Combate à Pobreza)
Para mais informações consulte campo
“pICMS”.
27 lista Lista que o C 1 P=Positiva, N=Negativa, U=Neutra,
medicamento pertence O=Outros ou se for vazio não se
trata de um medicamento
28 tipo Tipo do medicamento C 1 P=Referência, G=Genérico, S=Similar,
O=Outros ou se for vazio não se
trata de um medicamento
29 aliqPIS Alíquota PIS N 2v2-4 Só será retornado se parceiro e/ou
softwarehouse tiver comportamento
ativado e enviar faixa de
enquadramento.
30 aliqCOFINS Alíquota COFINS N 2v2-4 Só será retornado se
parceiro/softwarehouse tiver
comportamento ativado e enviar
faixa de enquadramento.
31 codANP Código ANP (Postos) C 9 Só será retornado se
parceiro/softwarehouse tiver
comportamento ativado.
32 CSTEntrada CST Entrada N 2 Só será retornado se
parceiro/softwarehouse tiver
comportamento ativado.
33 codBenef Código do benefício fiscal C 8 Exemplo; “PR810039”
por Estado
34 pDifer Percentual do Diferimento N 5v4 É o percentual que pode ser adiado o
de ICMS. pagamento do ICMS correspondente.
Por exemplo: 30% (pro mês seguinte).
35 CFOPCompraFora CFOP de compra de fora N 4 Só será retornado se
do Estado parceiro/softwarehouse tiver
comportamento ativado.
36 CFOPVendaFora CFOP de venda para fora N 4 Só será retornado se
do Estado parceiro/softwarehouse tiver
comportamento ativado.

Grupo IMendes - Manual de Integração com o WebService Tributário - 6

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

Exemplo XML de Envio:

<EnvioDados>
<Cabecalho>
<CNPJ>19992999000121</CNPJ>
<UF>GO</UF>
<CRT>3</CRT>
<CNAE>4771701</CNAE>
<tpConsulta>2</tpConsulta>
<codFaixa>01</codFaixa>
<versao>2.0</versao>
</Cabecalho>
<Produto>
<ID>1</ID>
<EAN>7891344000381</EAN>
<codigoInterno>37044</codigoInterno>
<descricao>LUBRAX EXTRA TURBO</descricao>
</Produto>
</EnvioDados>

NOTA:
O conteúdo do arquivo XML deve ser enviado de forma linearizada.
Exemplo:
<EnvioDados><Cabecalho><CNPJ>19992999000121</CNPJ><UF>GO</UF><CRT>3</CRT><CNAE>47
71701</CNAE><tpConsulta>2</tpConsulta><codFaixa>01</codFaixa><versao>2.0</versao>
</Cabecalho><Produto><ID>1</ID><EAN>7891344000381</EAN><codigoInterno>37044</codi
goInterno><descricao>LUBRAX EXTRA TURBO</descricao></Produto></EnvioDados>

Grupo IMendes - Manual de Integração com o WebService Tributário - 7

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

Exemplo XML Retorno:

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://tempuri.org/">
<?xml version="1.0" encoding="utf-8"?>
<Integracao>
<Cabecalho>
<CNPJ>19992999000121</CNPJ>
<dataHora>2018-04-17T13:41:21</dataHora>
<produtosEnviados>1</produtosEnviados>
<produtosRetornados>1</produtosRetornados>
<produtosPendentes_Interno>0</produtosPendentes_Interno>
<produtosPendentes_EAN>0</produtosPendentes_EAN>
<produtosPendentes_DataInicio>2018-04-17 </produtosPendentes_DataInicio>
<transacao>18670977</transacao>
<mensagem>AMBIENTE DE PRODUCAO</mensagem>
</Cabecalho>
<Produto>
<ID>1</ID>
<EAN>7891344000381</EAN>
<codigoInterno>37044</codigoInterno>
<CFOPCompra>1652</CFOPCompra>
<CFOPVenda>5656</CFOPVenda>
<CFOPCompraFora>2403</CFOPCompraFora>
<CFOPVendaFora>6403</CFOPVendaFora>
<CST>060</CST>
<CSOSN/>
<modBC>3</modBC>
<pICMS>17.00</pICMS>
<pICMSPDV>0.00</pICMSPDV>
<simbPDV>F</simbPDV>
<pRedBCICMS>0.00</pRedBCICMS>
<pRedBCICMSST>0.00</pRedBCICMSST>
<modBCST>4</modBCST>
<pICMSST>17.00</pICMSST>
<pMVAST>61.31</pMVAST>
<vPautaST>0.00</vPautaST>
<NCM>27101932</NCM>
<pIPI>0.00</pIPI>
<CSTIPI>53</CSTIPI>
<CSTPISCOFINSEntrada>50</CSTPISCOFINSEntrada>
<CSTPISCOFINSSaida>01</CSTPISCOFINSSaida>
<naturezaReceitaIsentaPISCOFINS/>
<CEST>06.007.00</CEST>
<pFCP>0.00</pFCP>
<lista/>
<tipo/>
<CSTEntrada>10</CSTEntrada>
<codBenef> PR810042</codBenef>
<pDifer>0.00</pDifer>
</Produto>
</Integracao>
</string>

Grupo IMendes - Manual de Integração com o WebService Tributário - 8

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

NOTA:
O conteúdo do arquivo XML também será retornado de forma linearizada.
Exemplo:

<?xml version="1.0" encoding="utf-8"?><string xmlns="http://tempuri.org/"><?xml

version="1.0" encoding="utf-
8"?><Integracao><Cabecalho><CNPJ>19992999000121</CNPJ><dataHora>2018-04-
17T13:41:21</dataHora><produtosEnviados>1</produtosEnviados><produtosRetornados>1
</produtosRetornados><produtosPendentes_Interno>0</produtosPendentes_Interno><pro
dutosPendentes_EAN>0</produtosPendentes_EAN><produtosPendentes_DataInicio>2018-
04-
17</produtosPendentes_DataInicio><transacao>18670977</transacao><mensagem>AMBIENT
E DE
PRODUCAO</mensagem></Cabecalho><Produto><ID>1</ID><EAN>7891344000381</EAN><codigo
Interno>37044</codigoInterno><CFOPCompra>1652</CFOPCompra><CFOPVenda>5656</CFOPVe
nda><CFOPCompraFora>2403</CFOPCompraFora><CFOPVendaFora>6403</CFOPVendaFora><CST>
060</CST><CSOSN/><modBC>3</modBC><pICMS>17.00</pICMS><pICMSPDV>0.00</pICMSPDV><si
mbPDV>F</simbPDV><pRedBCICMS>0.00</pRedBCICMS><pRedBCICMSST>0.00</pRedBCICMSST><m
odBCST>4</modBCST><pICMSST>17.00</pICMSST><pMVAST>61.31</pMVAST><vPautaST>0.00</v
PautaST><NCM>27101932</NCM><pIPI>0.00</pIPI><CSTIPI>53</CSTIPI><CSTPISCOFINSEntra
da>50</CSTPISCOFINSEntrada><CSTPISCOFINSSaida>01</CSTPISCOFINSSaida><naturezaRece
itaIsentaPISCOFINS/><CEST>06.007.00</CEST><pFCP>0.00</pFCP><lista/><tipo/><CSTEnt
rada>10</CSTEntrada><codBenef>PR810042</codBenef><pDifer>0.00</pDifer></Produto></Inte
gracao></string>

Grupo IMendes - Manual de Integração com o WebService Tributário - 9

 Manual de Integração com o WebService Tributário
Versão: 1.13 – 28/02/2019

ANEXO I - TABELA DE FAIXAS DE ENQUADRAMENTO (01/01/2018)

Código da Receita Bruta em 12 meses

Alíquota IRPJ CSLL COFINS PIS/Pasep CPP ICMS
Faixa (em R$)
98 LUCRO PRESUMIDO 3,65% 0,00% 0,00% 3,00% 0,65% 0,00% 0,00%
99 LUCRO REAL 9,25% 0,00% 0,00% 7,60% 1,65% 0,00% 0,00%
101 Até 180.000,00 4,0% 5,5% 3,5% 12,74% 2,76% 41.5% 34.0%
102 De 180.000,01 a 360.000,00 7,3% 5,5% 3,5% 12,74% 2,76% 41,5% 34,0%
103 De 360.000,01 a 720.000,00 9,5% 5,5% 3,5% 12,74% 2,76% 42,0% 33,5%
104 De 720.000,01 a 1.800.000,00 10,7% 5,5% 3,5% 12,74% 2,76% 42,0% 33,5%
105 De 1.800.000,01 a 3.600.000,00 14,3% 5,5% 3,5% 12,74% 2,76% 42,0% 33,5%
106 De 3.6000.000,01 a 4.800.000,00 19,0% 13,5% 10,0% 28,27% 6,13% 42,1% 0,00%

Grupo IMendes - Manual de Integração com o WebService Tributário - 10