C D V Centros de Desmanches de Veículos Automotores, 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
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. Versão 1.7 Página 2
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. Operação de homologação inválida para o serviço OPER_HOMOLOGACAO Conforme cada caso 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 1 OU 9 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 Versão 1.7 Página 3
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: 1 Solicitação da lista de grupo e subgrupo atendida com sucesso. Corpo da resposta: COD_ GRUPO 10 NOME_ GRUPO Automóveis de Passageiro COD_ SUBGRUPO SITUACAO_GRUPO DTH_ ATUALIZACAO _GRUPO A 2014-05-12 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 Versão 1.7 Página 4
201 Com motor de pistão alternativo de cilindrada superior a 50cm³ mas não superior a 250cm³ A 2014-05-12 202 Com motor de pistão alternativo de cilindrada superior a 250cm³ mas não superior a 500cm³ A 2014-05-13 203 Com motor de pistão alternativo de cilindrada superior a 500cm³ mas não superior a 800cm³ A 2014-05-13 204 Com motor de pistão alternativo de cilindrada superior a 800cm³ A 2014-05-14 OPER_HOMOLOGACAO = 2 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. Além do cabeçalho padrão as informações fornecidas serão: 1 Solicitação da lista de grupo e subgrupo atendida com sucesso. Corpo da resposta: COD_ GRUPO NOME_GRUPO 10 DTH_ ATUALIZACAO _GRUPO SITUACAO_GRUPO 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 Versão 1.7 Página 5
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 Com motor de pistão alternativo de cilindrada superior a 50cm³ mas não superior a 250cm³ I 2014-05-12 203 Com motor de pistão alternativo de cilindrada superior a 250cm³ mas não superior a 500cm³ I 2014-05-13 204 Com motor de pistão alternativo de cilindrada superior a 500cm³ mas não superior a 800cm³ I 2014-05-13 205 Com motor de pistão alternativo de cilindrada superior a 800cm³ I 2014-05-14 OPER_HOMOLOGACAO = 3 O campo OPER_HOMOLOGACAO igual a 3 indica que o Sistema de ERP deseja receber um status de erro do serviço solicitado. 9 Solicitação da lista de grupo e subgrupo com erro. COD_ERRO GS1 NOME_ERRO Nenhum grupo encontrado em cadastro. Versão 1.7 Página 6
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 OPER_HOMOLOGACAO = 1 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. Versão 1.7 Página 7
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. OPER_HOMOLOGACAO = 2 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. As informações fornecidas serão: Cabeçalho da resposta: 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 Versão 1.7 Página 8
TIPO_VEICULO AUTOMÓVEL PLACA_VEICULO CHASSI_VEICULO COD_GRUPO SITUACAO_PECA 1 PECA_ACOPLADO N COD_NOTA B1 OBSERVAÇÃO Em excelente estado. OPER_HOMOLOGACAO = 3 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 CE1 Item de estoque não localizado. NOME_ERRO Versão 1.7 Página 9
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: 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 Qualquer código de nota 5 COD_NOTA caracteres ULTIMO_ITEM_PESQUISADO 0 ou múltiplo de 5 Mensagem de retorno 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. Versão 1.7 Página 10
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. OPER_HOMOLOGACAO = 1 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 Versão 1.7 Página 11
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 OBSERVAÇÃO Igual ao solicitado ou vazio Texto livre. OPER_HOMOLOGACAO = 2 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 PE0 NOME_ERRO Todos os campos obrigatórios devem ser informados. OPER_HOMOLOGACAO = 3 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. 1 Solicitação da pesquisa de estoque atendida com sucesso. Versão 1.7 Página 12
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. Mensagem de retorno OPER_HOMOLOGACAO = 1 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. OPER_HOMOLOGACAO = 2 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 IRE5 NOME_ERRO A lista contém itens de estoque em situação que impede a comercialização: (1, 3, 6). Versão 1.7 Página 13
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 NFe. 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. Mensagem de retorno OPER_HOMOLOGACAO = 1 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. OPER_HOMOLOGACAO = 2 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 CNR2 A NF-e desta reserva já foi emitida. NOME_ERRO Versão 1.7 Página 14
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 A mensagem de entrada, conforme descrito no manual de integração, além do cabeçalho, conterá: CAMPO Informações gerais da nota fiscal de venda CHAVE_ACESSO_NFE PROTOCOLO_NFE NUMERO_NFE SERIE_NFE DTH_EMISSAO_NFE NATUREZA_OPERACAO_ NFE DIGEST_VALUE_NFE DESCRIÇÃO Chave de acesso da NF-e Protocolo de geração da NF-e informado pela SEFAZ/RS Número da NF-e Série da NF-e Data de emissão da nota fiscal Natureza da operação V(Venda), T(Transferência) ou E(Envio conserto) 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 Versão 1.7 Página 15
Mensagem de retorno OPER_HOMOLOGACAO = 1 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. OPER_HOMOLOGACAO = 2 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. Versão 1.7 Página 16
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 A mensagem de entrada, conforme descrito no manual de integração, além do cabeçalho, conterá: 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. Mensagem de retorno OPER_HOMOLOGACAO = 1 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. OPER_HOMOLOGACAO = 2 1 Solicitação de cancelamento da venda atendida com sucesso. 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. 9 Solicitação de cancelamento de venda com erro. COD_ERRO NOME_ERRO CNV2 Nota fiscal não localizada. Versão 1.7 Página 17
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. Mensagem de retorno OPER_HOMOLOGACAO = 1 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. As informações fornecidas serão: Cabeçalho da resposta: 1 Solicitação da validação de estoque atendida com sucesso. Versão 1.7 Página 18
Corpo da resposta: CAMPO COD_ESTOQUE MENSAGEM_BAIXA MENSAGEM_BAIXA_REDUZIDA VALOR Valor enviado na solicitação. Mensagem completa da situação pode não existir. Mensagem reduzida da situação pode não existir. OPER_HOMOLOGACAO = 2 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. I. Listar Peça 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...]). 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 OPER_HOMOLOGACAO = 1 O campo OPER_HOMOLOGACAO igual a 1 indica que o Sistema de ERP deseja receber uma relação das peças existentes em cadastro. Além do cabeçalho padrão as informações fornecidas serão: No cabeçalho da resposta: 1 Solicitação da lista de grupo e subgrupo atendida com sucesso. Versão 1.7 Página 19
Corpo da resposta: CAMPO NOME_PECA OBSERVACAO NOME_PECA NOME_PECA OBSERVACAO NOME_PECA OBSERVACAO NOME_PECA OBSERVACAO VALOR Alternador Obs Alternador Biela Carburador Obs Carburador Hélice Motor Ventoinha Obs Motor Ventoinha A peça Biela realmente não tem o campo OBSERVACAO e a peça Hélice tem o campo OBSERVACAO vazio - <OBSERVACAO/>. OPER_HOMOLOGACAO = 2 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 LP1 NOME_ERRO 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 A mensagem de entrada, conforme descrito no manual de integração, além do cabeçalho, conterá: Versão 1.7 Página 20
CAMPO Informações gerais da nota fiscal de entrada CHAVE_ACESSO_NFE PROTOCOLO_NFE COD_NOTA_FISCAL NUMERO_NFE SERIE_NFE DTH_EMISSAO_NFE NATUREZA_OPERACAO_ NFE DESCRIÇÃO Chave de acesso da NF-e Protocolo de geração da NF-e informado pela SEFAZ/RS Código da Nota informado pelo CDV Número da NF-e Série da NF-e Data de emissão da nota fiscal 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 Mensagem de retorno OPER_HOMOLOGACAO = 1 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. Versão 1.7 Página 21
OPER_HOMOLOGACAO = 2 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. Versão 1.7 Página 22