Linha Datasul

Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Linha Datasul

Segmento:

Backoffice

Módulo:

TOTVS Backoffice (Linha Datasul) - Faturamento (MFT)

Função:API - PATCH - ftp/api/v1/invoicePublic/{chave_nf}/updateDeliveryDate
html-mft.deliveryDate - Exportação/Importação Data de entrega Efetiva
País:Brasil
Requisito/Story/Issue:
  • DMANFATINOV-2011
  • DMANFATINOV-2010
  • DMANFATINOV-2109
  • DMANFATINOV-2110
  • DMANFATINOV-2131


02. SITUAÇÃO/REQUISITO


03. SOLUÇÃO


CHAMADA DA API:

Criado nova rota na API ftp/v1/invoicePublic para atualizar a data e a hora de entrega, essa nova rota é PATCH e pode ser usado conforme exemplo abaixo:

PATCH http://IP:PORTA/dts/datasul-rest/resources/prg/ftp/v1/invoicePublic/1;1;4416081/updateDeliveryDate

OBS: O formato da chave que vai no path parameter, logo após o invoicePublic/, é no formato: estabelecimento;serie;numero da nota.

OBS2: A API valida se a nota fiscal existe assim como também se a integração com o GFE esta ativa (e o parâmetro de atualiza data de entrega no CD0089 esta marcado).


No body da requisição é necessário enviar um JSON OBJECT contendo o "deliveryDate" e o "deliveryTime" que será o novo valor a ser atualizado na nota fiscal, exemplo do body:

{
    "deliveryDate": "2022-03-14",
    "deliveryTime": "14:30"
}

OBS: o formato da DATA é ano-mês-dia

os campos da nota fiscal onde essa informação ira ser salva é:



RETORNO DA API:

O retorno da API é um JSON OBJECT contendo a nota fiscal completa (tabela nota-fiscal), contendo a dt-entr-cli e a hr-entr-cli já atualizadas.
















Documento SWAGGER atualizado (https://editor.swagger.io/)

apipublicftp.json

Tela Exportação

Criado nova tela de exportação que é responsável por gerar um arquivo .csv com as notas fiscais de acordo com os filtros informados em tela,o arquivo gerado listará os seguintes campos respectivamente:

  • Estabelecimento;
  • Série;
  • Nr da nota;
  • Código Emitente;
  • Nome abreviado;
  • Natureza operaçăo;
  • Data de emissăo;
  • Data de entrega;
  • hora da entrega;


Conteúdo do arquivo gerado
Estabelecimento;Série;Nr da nota;Código Emitente;Nome abreviado;Natureza operação;Data de emissão;Data de entrega;hora da entrega
1;1;8888888;1111111;meu nome;11111;01/03/2024;"";""


Exemplo de arquivo gerado: 

exemplo_arquivo _gerado.csv

Tela Importação

Criado nova tela de importação que é responsável pela importação através de arquivo .csv, que deve utilizar o mesmo formato da tela de Exportação, os campos a serem atualizados no arquivo são:

  • Data de entrega (nota-fiscal.dt-entr-cli) formato aceito: 
    • DD/MM/YYYY.
  • Hora  da entrega (nota-fiscal.hr-entr-cli) formato aceito:
    • HH:MM:SS.

Registros com dados/formato inválido não serão atualizados.

Conteúdo do arquivo a ser importado
Estabelecimento;Série;Nr da nota;Código Emitente;Nome abreviado;Natureza operação;Data de emissão;Data de entrega;hora da entrega
1;1;8888888;1111111;meu nome;11111;01/03/2024;01/04/2024;12:00:00

No faturamento de Pedidos (FT4002) e embarques (FT4001) ao selecionar o pedido/embarque para calculo a data base para a duplicata será atualizada com a data de entrega do pedido caso o parâmetro "Data base para o vencimento dos títulos de E-commerce" esteja marcado como "Data Previsão Entrega" na central de configurações do e-commerce (html.ecommerceConf)

Alterado regra para visualização do campo de "Dt Vencto Orig" na aba de duplicatas do FT0904B, para também ser apresentado para nota fiscais vinculadas a pedidos do e-commerce (ped-venda.origem = 22)



04. DEMAIS INFORMAÇÕES

Documento de referência - Exportação/Importação Data de entrega Efetiva