Desenvolvimento Millen-27457 - E-commerce API - novo campo na API para retornar a data de emissão da NF de entrada
Release 103
Desenvolvimento Millen-14488 – Disponibilizar informações de VENDEDOR na API Lista Faturamento
Release 102
Desenvolvimento Millen-15769 - Api Lista Faturamentos - Formato do Campo "Série" de NF
Release 101
Versão 5
Autor Jaciara Silva
Processo: Vendas
Nome do Processo: Movimentações
Motivação
A empresa utiliza a Api "MILLENIUM_ECO.PEDIDO_VENDA.ListaFaturamentos" para integração das notas fiscais com os outros sistemas utilizados em seus ambientes. A Api retorna à informação referente à série da nota fiscal como "003" (string), pois é a forma como é gravada no banco de dados.
No entanto, quando alguma validação do XML é realizada por algum dos ERPs utilizados no ambiente, ele recebe o valor "003", o que provoca o retorno de uma mensagem de erro, pois é aguardada a informação em formato numérico "3", número inteiro.
Para possibilitar que a empresa faça as integrações entre os vários sistemas de seu ambiente, foi necessário disponibilizar a informação, da série da nota fiscal, em um novo parâmetro de retorno da Api utilizada, na qual será retornada com o valor do tipo "inteiro", eliminando o conflito existente entre os ERPs.
Após análise foi verificado que o valor listado pela API é apenas o espelhamento da informação contida na base de dados, assim, não podendo ser alterado o valor apresentado. No XML/PDF, o sistema da SEFAZ que omite os zeros.
Como solução de contorno, pode-se ainda criar uma extensão, na qual podemos criar um campo auxiliar, SERIE_NF_NUMERICO, para gravar a série como número inteiro.
Nessa extensão, foi protegido o cast, e se realmente o número puder ser convertido, será trazido o inteiro do campo série. Se a conversão não for possível, deve-se deixar nulo.
Importante frisar que não será modificado o comportamento do campo atual, e sim será criado o campo na API que retorna à informação como ele precisa.
Observação 1: A millen-14488 complementa este recurso disponibilizando na Api de lista de faturamentos parâmetro para informação de código e nome do vendedor da movimentação relacionada e o CPF NF Paulista.
No método millenium_eco!mPegada.PEDIDO_VENDA.ListaFaturamentos inserido campos COD_VENDEDOR (string 10), NOME_VENDEDOR (string 120) e CPF_NFPAULISTA (string 14)
OBS.:VENDEDOR (inteiro) para COD_VENDEDOR (string 10)
Observação 2: A millen-27457 complementa este recurso disponibilizando novo campo para retornar a data de emissão da NFe de entrada, na API MILLENIUM_ECO.PEDIDO_VENDA.ListaFaturamentos, na integração de suas movimentações, notas de entradas e de saídas com outros sistemas.
Atenção! Este recurso não acompanha a versão do sistema. Para utilizá-lo, solicite aos nossos consultores que forneçam o módulo para instalação. Caso você não consiga fazer a instalação, entre em contato com nosso departamento comercial e solicite a visita de um consultor.
Parâmetros
Instalar o módulo millenium_eco!mpegada.minst. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.
Em Utilitários\Administrador\Eventos, selecione o evento de faturamento de vendas e configure:
- Na guia Vendas -ligar o parâmetro Usar Vendedor
- Na guia Fiscal - ligar o parâmetro Nota Fiscal Paulista
Entradas
Em Vendas\Movimentações, ao emitir a nota fiscal, a série selecionada poderá estar no formato de string. O sistema irá identificar o formato e, quando for necessário e se o recurso estiver ativo no sistema, fará a conversão para número inteiro, para enviar a informação na API.
Observe que na tela de finalização da operação a série selecionada foi "010" mas a informação foi salva no campo serie_nf_numerico apenas como "10".
Na imagem abaixo podemos ver como seria o envio da informação da série da nota sem o recurso de conversão ativado. O campo preenchido é serie_nf e está preenchido com "010", igual à tela de finalização da operação.
As informações do vendedor e CPF do consumidor selecionadas na tela do evento de movimentação de venda serão integradas, conforme ajuste realizado na API.
Validações e Saídas
1.A instalação do módulo específico, fará com que a informação do campo serie_nf seja convertida para numérico e preencherá o campo serie_nf_numerico, para enviar na API.
2.Insere os campos:
COD_VENDEDOR (string 10)
NOME_VENDEDOR (string 120)
CPF_NFPAULISTA (string 14)
3. Insere o campo:
DATA_NF