C D V Centros de Desmanches de Veículos Automotores, Comércio de Peças Usadas e Reciclagem de Sucatas

(1)

C D V Comércio de Peças Usadas e Reciclagem de Sucatas

Manual de Orientações para Homologação da Integração do Sistema GID Desmanches e dos Sistemas Emissores de Nota Fiscal

Eletrônica

Versão 1.7

Abril de 2015

(2)

Versão 1.7 Página 2

ORIENTAÇÕES PARA O AMBIENTE DE HOMOLOGAÇÃO

Antes de ler esse documento recomenda-se a leitura do Manual de Integração do Sistema GID Desmanches e Sistemas Emissores de Nota Fiscal Eletrônica.

1. Objetivo e forma de utilização

Com o objetivo de auxiliar nos testes de integração dos sistemas emissores de Nota Fiscal Eletrônica, aqui chamado de Sistema de ERP, com o sistema GID Desmanches, o DETRAN/RS está disponibilizando um ambiente de homologação na Internet. Este ambiente, mesmo sendo de homologação, trafegará com protocolo HTTPS e exige que todas as mensagens enviadas pelo Sistema de ERP estejam assinadas por um certificado válido e emitido por autoridade certificadora credenciada no ICP-Brasil.

A implantação na loja de desmanche utilizará o mesmo ambiente de homologação, isto é, a Internet pública fornecida pelo CDV.

A URL do ambiente de homologação na Internet é:

desmanches.hml.detran.rs.gov.br/integracaonfe?wsdl

O ambiente de homologação fornece diversos tipos de respostas, de acordo com a informação recebida no campo OPER_HOMOLOGACAO, constante do cabeçalho da mensagem enviada.

OPER_HOMOLOGACAO igual a 1

Indica que o sistema que está utilizando o serviço deseja receber uma mensagem de sucesso no acesso.

OPER_HOMOLOGACAO maior que 1 (2, 3...)

Indica que o sistema que está utilizando o serviço do sistema GID Desmanches deseja:

• Receber uma mensagem de erro para testar seu processamento neste caso;

• Receber uma mensagem que exija uma ação de alteração sobre o seu banco de dados;

• Receber uma mensagem de retorno com continuidade do processamento iniciado.

O valor informado no campo OPER_HOMOLOGACAO deve estar dentro das alternativas previstas para cada serviço demandado, conforme descrito a seguir. No ambiente de produção, dentro da loja de desmanche, o campo OPER_HOMOLOGACAO não é considerado pelo sistema GID Desmanches.

As situações de teste disponibilizadas não esgotam todas as que devem ser feitas. São um apoio para a depuração da integração entre os sistemas.

(3)

2. Padrão de cabeçalho

As mensagens de relacionamento entre o Sistema de ERP e o sistema GID Desmanches possuem um cabeçalho de chamada do serviço, gerado pelo Sistema de ERP, e um cabeçalho de resposta, gerado pelo sistema GID Desmanches.

Cabeçalho da mensagem de chamada do serviço gerado pelo Sistema de ERP

Tratando-se de um ambiente de homologação, as informações constantes do cabeçalho das mensagens sempre serão iguais para todas as empresas que estiverem homologando. Informe exatamente os valores preenchidos na tabela abaixo. Se desejar testar mensagens de exceção basta alterar os dados informados abaixo e receberá os erros previstos na tabela.

CAMPO CONTEÚDO ERRO SE CONTEÚDO DIFERENTE - EXCEÇÃO COD_CREDENCIADO CDV99999 Credenciado inexistente na base de dados de DETRAN/RS.

SENHA_CREDENCIADO Não será consistido.

CNPJ_CREDENCIADO 11111111111180 CNPJ do Credenciado difere do CNPJ do Certificado Digital.

COD_AMBIENTE 2 Ambiente inválido.

MATR_OPER Não será consistido.

VERSAO_LEIAUTE 1 Versão do leiaute difere da atual.

OPER_HOMOLOGACAO Conforme cada caso

Operação de homologação inválida para o serviço solicitado.

Cabeçalho de resposta do sistema GID Desmanches

A mensagem recebida pelo Sistema de ERP sempre virá com o cabeçalho contendo:

IDT_SISTEMA_RETORNO Texto fixo - GID-DESMANCHES

SENHA_RETORNO Em branco

COD_AMBIENTE 2

COD_STATUS 1 OU 9

NOME_STATUS Texto previsto no manual de integração para cada caso

COD_ERRO Um dos códigos previstos no manual de integração se cod_status for 9 NOME_ERRO Texto previsto no manual de integração para cada caso

(4)

3. Serviços disponíveis

A. Listar grupos e subgrupos

Para solicitar as tabelas de Grupo e Subgrupo o Sistema de ERP chama o método “Listar Grupos e Subgrupos” do Web Service do sistema GID Desmanches passando somente o cabeçalho informado anteriormente.

Nome do método - listarGruposSubgruposGid( ) Mensagem de retorno

• OPER_HOMOLOGACAO = 1

O campo OPER_HOMOLOGACAO igual a 1 indica que o Sistema de ERP deseja receber uma relação dos grupos e subgrupos existentes em cadastro.

Além do cabeçalho padrão as informações fornecidas serão:

No cabeçalho da resposta:

COD_STATUS NOME_STATUS

1 Solicitação da lista de grupo e subgrupo atendida com sucesso.

Corpo da resposta:

COD_

GRUPO

NOME_

GRUPO SITUACAO_GRUPO

DTH_

ATUALIZACAO _GRUPO 10 Automóveis

de Passageiro A 2014-05-12

COD_

SUBGRUPO NOME_SUBGRUPO SITUACAO_

SUBGRUPO

DTH_

ATUALIZACAO_

SUBGRUPO 101 De cilindrada não superior a 1.000cm³ A 2014-05-12

102 De cilindrada superior a 1.000cm³, mas

não superior a 1.500cm³ A 2014-05-13

20 Motocicletas A 2014-05-12

COD_

SUBGRUPO NOME_SUBGRUPO SITUACAO_

SUBGRUPO

DTH_

ATUALIZACAO_

SUBGRUPO

(5)

O campo OPER_HOMOLOGACAO igual a 2 indica que o Sistema de ERP deseja receber uma relação de grupos e subgrupos com grupos e subgrupos inativados e novos grupos e subgrupos.

Corpo da resposta:

201

Com motor de pistão alternativo de cilindrada superior a 50cm³ mas não

superior a 250cm³

A 2014-05-12

202

superior a 500cm³

A 2014-05-13

203

superior a 800cm³

A 2014-05-13

204 Com motor de pistão alternativo de

cilindrada superior a 800cm³ A 2014-05-14

COD_

GRUPO NOME_GRUPO SITUACAO_GRUPO

DTH_

ATUALIZACAO _GRUPO 10

Automóveis de

Passageiro A 2014-05-12

COD_

SUBGRUPO NOME_SUBGRUPO

SITUACAO_

SUBGRUPO

DTH_

ATUALIZACAO_

SUBGRUPO 101 De cilindrada não superior a 1.000cm³ A 2014-05-12

102

De cilindrada superior a 1.000cm³, mas

não superior a 1.500cm³ I 2014-05-15

103

De cilindrada superior a 1.500cm³, mas

não superior a 3.000cm³ A 2014-05-15

(6)

O campo OPER_HOMOLOGACAO igual a 3 indica que o Sistema de ERP deseja receber um status de erro do serviço solicitado.

A resposta será somente o cabeçalho com:

9 Solicitação da lista de grupo e subgrupo com erro.

COD_ERRO NOME_ERRO

GS1 Nenhum grupo encontrado em cadastro.

104 De cilindrada superior a 3.000cm³ A 2014-05-15

20 Motocicletas I 2014-05-16

COD_

SUBGRUPO NOME_SUBGRUPO

SITUACAO_

SUBGRUPO

DTH_

ATUALIZACAO_

SUBGRUPO

201

superior a 250cm³ I 2014-05-12

203

204

205

Com motor de pistão alternativo de

cilindrada superior a 800cm³ I 2014-05-14

(7)

Versão 1.7 Página 7 B. Consultar estoque

O Sistema de ERP chama o método “Consultar Estoque” do Web Service do sistema GID Desmanches sempre que desejar realizar uma consulta direta a um item de estoque. A consulta ao estoque pressupõe que o atendente do CDV possui o código de cadastramento do item no estoque. Este código pode ser obtido nas etiquetas que estão nas peças ou no sistema GID Desmanches.

Nome do método - consultarEstoqueGid( ) Mensagem de entrada

Além do cabeçalho padrão será informado:

ID CAMPO DESCRIÇÃO PAI TIPO OCOR TAM

A Informação da peça procurada 1-1

A01 COD_ESTOQUE Código de identificação do item no estoque. A N 1-1 10

O código de estoque enviado para fins de homologação pode ser qualquer um pois o sistema responderá de acordo com o campo OPER_HOMOLOGACAO do cabeçalho da mensagem enviada pelo Sistema de ERP.

Mensagem de retorno

O campo OPER_HOMOLOGACAO igual a 1, no método Consultar Estoque, indica que o Sistema de ERP deseja receber uma peça obtida com sucesso.

As informações fornecidas serão:

Cabeçalho da resposta:

1 Solicitação da consulta de estoque atendida com sucesso.

(8)

Versão 1.7 Página 8 Corpo da resposta:

CAMPO VALOR

COD_ESTOQUE Valor enviado na solicitação NOME_PECA Alma Para-choque Dianteiro NOME_ORIGINARIO Conj. Chassi/Monobloco

NOME_MARCA VOLKSWAGEN

NOME_MODELO FOX 1.0 PLUS

ANO_MODELO 2010

TIPO_VEICULO AUTOMÓVEL PLACA_VEICULO ZZZ9999

CHASSI_VEICULO 9BWXXX23JDI004047

COD_GRUPO 20

SITUACAO_PECA 1

PECA_ACOPLADO N

COD_NOTA A1

OBSERVAÇÃO Em excelente estado.

O campo OPER_HOMOLOGACAO igual a 2, no método Consultar Estoque, indica que o Sistema de ERP deseja receber outra peça, diferente da primeira, obtida com sucesso.

1 Solicitação da consulta de estoque atendida com sucesso.

Corpo da resposta:

CAMPO VALOR

COD_ESTOQUE Valor enviado na solicitação

NOME_PECA Motor

NOME_ORIGINARIO Conj. Chassi/Monobloco

NOME_MARCA FORD

NOME_MODELO CORCEL

ANO_MODELO

(9)

Versão 1.7 Página 9 TIPO_VEICULO AUTOMÓVEL

PLACA_VEICULO CHASSI_VEICULO

COD_GRUPO

SITUACAO_PECA 1

PECA_ACOPLADO N

COD_NOTA B1

OBSERVAÇÃO Em excelente estado.

O campo OPER_HOMOLOGACAO igual a 3, no método Consultar Estoque, indica que o Sistema de ERP deseja receber uma mensagem de erro para a consulta de estoque.

9 Solicitação da consulta de estoque com erro.

COD_ERRO NOME_ERRO

CE1 Item de estoque não localizado.

(10)

Versão 1.7 Página 10 C. Pesquisar estoque

O Sistema de ERP chama o método de “Pesquisar Estoque” do Web Service do sistema GID Desmanches sempre que precisar realizar uma pesquisa por nome e/ou placa e/ou código da nota fiscal. Juntamente com esses parâmetros de pesquisa pode informar o nome ou parte do nome da peça e opcionalmente a marca do veículo, seu modelo e ano do modelo. Recebe um conjunto vazio, se nada for encontrado ou uma relação de até 50(cinqüenta) peças que atendem a pesquisa. Para pesquisar as próximas 50 peças o Sistema de ERP deve realizar outra pesquisa informando a posição da última peça pesquisada. Para fins do ambiente de homologação o intervalo de retorno será de 5 em 5 peças.

Nome do método - pesquisarEstoqueGid( ) Mensagem de entrada

A mensagem de entrada, no caso da homologação, não será utilizada pelo sistema GID Desmanches para realizar uma pesquisa. As respostas são todas elaboradas previamente. O campo ULTIMO_ITEM_PESQUISADO será usado para que a cada 5 itens retorne um novo conjunto de componentes. Em produção esse intervalo será de 50 em 50 peças.

Além do cabeçalho da mensagem deverá compor a mensagem de entrada:

A mensagem de retorno do sistema GID Desmanches, no ambiente de homologação, usará as informações colocadas pelo Sistema de ERP na mensagem de entrada.

COD_ESTOQUE – Código gerado pelo sistema GID Desmanches.

NOME_PECA – Será utilizado o nome da peça informada na mensagem de entrada. Se o nome da peça não for informado o sistema devolverá a palavra PEÇA.

NOME_ORIGINARIO – Se o nome da peça foi informado, constará na mensagem de retorno o Conj. Chassi/Monobloco. Se o nome da peça não for informado o sistema devolverá a palavra ORIGINÁRIO.

CAMPO VALOR

NOME_PECA Qualquer nome de peça NOME_MARCA Qualquer marca ou nenhuma NOME_MODELO Qualquer modelo ou nenhum ANO_MODELO Qualquer ano ou nenhum PLACA_VEICULO Qualquer placa – 7 caracteres CHASSI_VEICULO Qualquer chassi - 21 caracteres COD_NOTA

Qualquer código de nota – 5 caracteres

ULTIMO_ITEM_PESQUISADO 0 ou múltiplo de 5

(11)

Versão 1.7 Página 11 NOME_MARCA - Se a marca foi informada constará na mensagem de retorno essa marca.

Se a marca não for informada o sistema GID Desmanches retornará sempre a palavra MARCA.

NOME_MODELO - Se o modelo foi informado constará na mensagem de retorno esse modelo. Se o modelo não for informado o sistema GID Desmanches retornará sempre a palavra MODELO.

ANO_MODELO – Se o ano do modelo do veículo foi informado constará na mensagem de retorno esse ano. Se o ano do modelo não for informado o sistema GID Desmanches retornará sempre 2010.

TIPO_VEÍCULO – Sempre será a palavra AUTOMÓVEL.

PLACA_VEÌCULO – Será utilizada a placa informada na mensagem de entrada. Se não for informada ficará sem conteúdo.

CHASSI_VEICULO – Será utilizado chassi informado na mensagem de entrada.

COD_GRUPO – sempre será o número 10.

SITUACAO_PECA – sempre será o número 1.

PECA_ACOPLADA – sempre será a letra N.

COD_NOTA - Será utilizado o código da nota fiscal de compra informada na mensagem de entrada. Se não for informada ficará sem conteúdo.

OBSERVAÇÃO – textos livres.

O campo OPER_HOMOLOGACAO igual a 1, no método de Pesquisar Estoque, devolve sempre um conjunto de 5 peças. Em produção o sistema sempre enviará as 50 peças seguintes a partir do número sequencial do último item pesquisado.

A mensagem de retorno conterá 5 itens de estoque e será formada por : Cabeçalho da resposta:

1 Solicitação da pesquisa de estoque atendida com sucesso.

Corpo da resposta:

CAMPO VALOR

COD_ESTOQUE Número aleatório.

NOME_PECA Igual ao solicitado ou PEÇA

NOME_ORIGINARIO Conj. Chassi/Monobloco ou ORIGINÁRIO NOME_MARCA Igual a solicitada ou MARCA

(12)

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Pesquisar Estoque, que o Sistema de ERP deseja receber uma mensagem de erro.

9 Solicitação da pesquisa de estoque com erro.

COD_ERRO NOME_ERRO

PE0 Todos os campos obrigatórios devem ser informados.

O campo OPER_HOMOLOGACAO igual a 3, no método Pesquisar Estoque, indica que o Sistema de ERP deseja receber uma pesquisa correta mas sem a informação de nenhuma peça, como se não tivesse localizado nada em cadastro.

NOME_MODELO Igual a solicitada ou MODELO ANO_MODELO Igual ao solicitado ou 2010 TIPO_VEICULO AUTOMÓVEL

PLACA_VEICULO Igual ao solicitado ou vazio CHASSI_VEICULO Igual ao solicitado ou vazio

COD_GRUPO 10

SITUACAO_PECA 1

PECA_ACOPLADA N

COD_NOTA Igual ao solicitado ou vazio OBSERVAÇÃO Texto livre.

1 Solicitação da pesquisa de estoque atendida com sucesso.

(13)

Versão 1.7 Página 13 D.Incluir reserva de estoque

O Sistema de ERP chama o método de “Incluir Reserva de Estoque” do Web Service do sistema GID Desmanches obrigatoriamente no mesmo processo de geração da NF-e. O chamado deve ocorrer antes de encaminhar o XML de uma nota fiscal para a SEFAZ/RS e não pode depender de ação do operador. Se estiver operando em contingência realize a reserva normalmente.

Para teste, lembre-se que o ambiente da SEFAZ/RS também deve ser de homologação.

Nome do método - incluirReservaEstoqueGid( ) Mensagem de entrada

A mensagem de entrada, conforme descrito no manual de integração, além do cabeçalho padrão, conterá:

• CHAVE_ACESSO_NFE - chave de acesso gerada para a NF-e que será emitida.

• COD_ESTOQUE - código de identificação do item no estoque (peça). Deve ter no mínimo 1 e no máximo 990 ocorrências.

O campo OPER_HOMOLOGACAO igual a 1 indica, no método Incluir Reserva de Estoque, que o Sistema de ERP deseja receber uma confirmação da inclusão da reserva.

1 Solicitação de inclusão de reserva atendida com sucesso.

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Incluir Reserva de Estoque, que o Sistema de ERP deseja receber um erro indicando que algum item do estoque não pode ser comercializado.

9 Solicitação de inclusão de reserva com erro.

COD_ERRO NOME_ERRO

IRE5

A lista contém itens de estoque em situação que impede a comercialização:

(1, 3, 6).

(14)

Versão 1.7 Página 14 E. Cancelar reserva de estoque

O Sistema de ERP chama o método de “Cancelar Reserva de Estoque” do Web Service do sistema GID Desmanches sempre que:

• A SEFAZ/RS, neste caso em ambiente de homologação, não autorizar a NF-e;

• Ocorrer algum problema que impeça a emissão da NF-e e obrigue a geração de nova NF- e.

O cancelamento da reserva de estoque não deve ser uma ação do operador e sim uma ação de sistema quando verificar que não foi possível gerar a nota fiscal eletrônica. Nos casos de operação em contingência a reserva não deve ser desfeita.

Nome do método - cancelarReservaEstoqueGid( ) Mensagem de entrada

A mensagem de entrada, conforme descrito no manual de integração, além do cabeçalho, conterá:

• CHAVE_ACESSO_NFE - chave de acesso gerada para a NF-e cuja reserva será cancelada.

O campo OPER_HOMOLOGACAO igual a 1 indica, no método Cancelar Reserva de Estoque, que o Sistema de ERP deseja receber uma resposta de cancelamento da reserva com sucesso.

1 Solicitação de cancelamento de reserva atendida com sucesso.

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Cancelar Reserva de Estoque, que o Sistema de ERP deseja receber um erro indicando que não é possível cancelar a reserva solicitada.

9 Solicitação de cancelamento de reserva com erro

COD_ERRO NOME_ERRO

CNR2 A NF-e desta reserva já foi emitida.

(15)

Versão 1.7 Página 15 F. Confirmar venda

O Sistema de ERP chama o método de “Confirmar Venda” do Web Service do sistema GID Desmanches sempre que uma Nota Fiscal Eletrônica de Saída emitida pelo CDV for autorizada pela SEFAZ/RS.

Nome do método - confirmarVendaGid( ) Mensagem de entrada

CAMPO DESCRIÇÃO Informações gerais da nota fiscal de venda

CHAVE_ACESSO_NFE Chave de acesso da NF-e

PROTOCOLO_NFE Protocolo de geração da NF-e informado pela SEFAZ/RS

NUMERO_NFE Número da NF-e

SERIE_NFE Série da NF-e

DTH_EMISSAO_NFE Data de emissão da nota fiscal

NATUREZA_OPERACAO_ NFE Natureza da operação V(Venda), T(Transferência) ou E(Envio conserto)

DIGEST_VALUE_NFE Confere a integridade da NFe

Identificação do cliente

CNPJ_CPF CNPJ ou CPF do cliente

TIPO Tipo de pessoa

NOME Razão social ou nome se pessoa física

NOME_FANTASIA Nome de fantasia

INSC_ESTADUAL Inscrição estadual

RG Número do Registro Geral

EMAIL E-mail do cliente

NRO_TELEFONE Número de telefone

NRO_CELULAR Número do celular

Grupo do Endereço do Cliente

NOME_LOGRADOURO Nome do logradouro

NUMERO Número do estabelecimento

COMPLEMENTO Complemento do endereço

NOME_BAIRRO Bairro

COD_MUNICIPIO Código do município do IBGE

UF Sigla da UF

NRO_CEP Código do CEP

Peças comercializadas na nota fiscal eletrônica de 1 a 990 ocorrências

COD_ESTOQUE Código do item no estoque

(16)

Versão 1.7 Página 16 Mensagem de retorno

O campo OPER_HOMOLOGACAO igual a 1 indica, no método Confirmar Venda, que o Sistema de ERP deseja receber uma resposta de confirmação de venda ocorrida com sucesso.

1 Solicitação de confirmação de venda atendida com sucesso.

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Confirmar Venda, que o Sistema de ERP deseja receber um erro indicando que a venda não pode ser confirmada e portanto as peças continuam na situação de reservadas e não foram baixadas do estoque.

9 Solicitação de confirmação de venda com erro.

COD_ERRO NOME_ERRO

CV2 NF-e não encontrada na SEFAZ/RS.

(17)

Versão 1.7 Página 17 G. Cancelar venda

O Sistema de ERP chama o método de “Cancelar Venda” do Web Service do sistema GID Desmanches sempre que uma solicitação de cancelamento de uma Nota Fiscal Eletrônica de Saída, emitida pelo CDV, ou uma Nota Fiscal Eletrônica de Estorno for autorizada pela SEFAZ/RS.

Nome do método - cancelarVendaGid( ) Mensagem de entrada

• PROTOCOLO_CANCELAMENTO_NFE – protocolo de autorização do cancelamento ou estorno da NF-e. Obrigatório se for um cancelamento.

• PROTOCOLO_ESTORNO_NFE – protocolo de autorização da NF-e de estorno. Obrigatório se for um estorno.

• CHAVE_ACESSO_NFE - chave de acesso da NF-e a ser cancelada ou estornada.

• CHAVE_ACESSO_NFE_ESTORNO – chave de acesso da NF-e de estorno. Obrigatória de tratar-se de um estorno.

O campo OPER_HOMOLOGACAO igual a 1 indica, no método Cancelar Venda, que o Sistema de ERP deseja receber uma resposta de confirmação do cancelamento da venda.

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Cancelar Venda, que o Sistema de ERP deseja receber um erro indicando que o cancelamento da venda não pode ser realizado e portanto as peças continuam na situação de baixadas do estoque por venda.

1 Solicitação de cancelamento da venda atendida com sucesso.

9 Solicitação de cancelamento de venda com erro.

COD_ERRO NOME_ERRO

CNV2 Nota fiscal não localizada.

(18)

Versão 1.7 Página 18 H.Validar Estoque

O Sistema de ERP chama o método “Validar Estoque” do Web Service do sistema GID Desmanches para saber que ações ocorrerão no estoque ao ser realizada a comercialização de uma peça. O método Valida Estoque pode receber um ou mais código de peças. Como retorno o Sistema de ERP recebe o código de estoque informado e uma mensagem longa e outra reduzida.

Se a peça não estiver acoplada o código de estoque virá sozinho. Esse método não é de uso obrigatório mas auxilia na operação do CDV.

Nome do método - validarEstoqueGid( ) Mensagem de entrada

Além do cabeçalho padrão será informado:

ID CAMPO DESCRIÇÃO PAI TIPO OCOR TAM

A Informação da peça procurada 1-990

A01 COD_ESTOQUE Código de identificação do item no estoque. A N 1-990 10

O código de estoque enviado para fins de homologação pode ser qualquer um pois o sistema responderá de acordo com o campo OPER_HOMOLOGACAO do cabeçalho da mensagem enviada pelo Sistema de ERP.

O campo OPER_HOMOLOGACAO igual a 1, no método Validar Estoque, indica que o Sistema de ERP deseja simular uma validação ocorrida com sucesso.

1 Solicitação da validação de estoque atendida com sucesso.

(19)

CAMPO VALOR

COD_ESTOQUE Valor enviado na solicitação.

MENSAGEM_BAIXA Mensagem completa da situação – pode não existir.

MENSAGEM_BAIXA_REDUZIDA Mensagem reduzida da situação – pode não existir.

O campo OPER_HOMOLOGACAO igual a 2, no método Validar Estoque, indica que o Sistema de ERP deseja receber uma mensagem de erro para a validação de estoque.

9 Solicitação de validação de estoque com erro.

COD_ERRO NOME_ERRO

VE2 A lista contém itens de estoque não encontrados: ([ 99 99...]).

I. Listar Peça

Para solicitar a tabela de peças o Sistema de ERP chama o método “Listar Peça” do Web Service do sistema GID Desmanches passando somente o cabeçalho informado anteriormente.

Nome do método - listarPecaGid( ) Mensagem de retorno

O campo OPER_HOMOLOGACAO igual a 1 indica que o Sistema de ERP deseja receber uma relação das peças existentes em cadastro.

No cabeçalho da resposta:

(20)

A peça Biela realmente não tem o campo OBSERVACAO e a peça Hélice tem o campo OBSERVACAO vazio - <OBSERVACAO/>.

O campo OPER_HOMOLOGACAO igual a 2 indica que o Sistema de ERP deseja receber um status de erro do serviço solicitado.

9 Solicitação da lista de peças com erro.

COD_ERRO NOME_ERRO

LP1 Nenhuma peça encontrada em cadastro.

J. Cadastrar Nota Fiscal de Entrada

O Sistema de ERP chama o método de “Cadastrar Nota Fiscal de Entrada” do Web Service do sistema GID Desmanches sempre que uma Nota Fiscal Eletrônica de Entrada emitida pelo CDV for autorizada pela SEFAZ/RS.

Nome do método - cadastrarNotaFiscalEntradaGid( ) Mensagem de entrada

CAMPO VALOR

NOME_PECA Alternador OBSERVACAO Obs Alternador

NOME_PECA Biela

NOME_PECA Carburador

OBSERVACAO Obs Carburador NOME_PECA Hélice

OBSERVACAO

NOME_PECA Motor Ventoinha OBSERVACAO Obs Motor Ventoinha

(21)

Versão 1.7 Página 21 CAMPO DESCRIÇÃO

Informações gerais da nota fiscal de entrada

CHAVE_ACESSO_NFE Chave de acesso da NF-e

PROTOCOLO_NFE Protocolo de geração da NF-e informado pela SEFAZ/RS COD_NOTA_FISCAL Código da Nota informado pelo CDV

NUMERO_NFE Número da NF-e

SERIE_NFE Série da NF-e

DTH_EMISSAO_NFE Data de emissão da nota fiscal

NATUREZA_OPERACAO_ NFE Natureza da operação C(Compra), T(Transferência) DIGEST_VALUE_NFE Confere a integridade da NFe

Identificação do Fornecedor

CNPJ_CPF CNPJ ou CPF do fornecedor

TIPO Tipo de pessoa

NOME Razão social ou nome se pessoa física

NOME_FANTASIA Nome de fantasia

INSC_ESTADUAL Inscrição estadual

RG Número do Registro Geral

EMAIL E-mail do fornecedor

NRO_TELEFONE Número de telefone

NRO_CELULAR Número do celular

Grupo do Endereço do Fornecedor

NOME_LOGRADOURO Nome do logradouro

NUMERO Número do estabelecimento

COMPLEMENTO Complemento do endereço

NOME_BAIRRO Bairro

COD_MUNICIPIO Código do município do IBGE

UF Sigla da UF

NRO_CEP Código do CEP

Peças comercializadas na nota fiscal eletrônica de 1 a 990 ocorrências

COD_ESTOQUE Código do item no estoque

O campo OPER_HOMOLOGACAO igual a 1 indica, no método Cadastrar Nota Fiscal de Entrada, que o Sistema de ERP deseja receber uma resposta de confirmação de cadastro ocorrida com sucesso.

1 Solicitação de cadastro de nota de entrada atendida com sucesso.

(22)

O campo OPER_HOMOLOGACAO igual a 2 indica, no método Cadastrar Nota Fiscal de Entrada, que o Sistema de ERP deseja receber um erro indicando que o cadastro não pode ser realizado e portanto a nota de entrada não foi salva no GID Desmanches.

9 Solicitação de cadastro de nota de entrada com erro.

COD_ERRO NOME_ERRO

CNE1 Chave de Acesso da NFe inválida.