...
| Produto: | | Solucoes_totvs_cross |
|---|
| SolucaoCross | TOTVS Backoffice |
|---|
|
| Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | Modulos_cross_segmentos |
|---|
| ModulosCrossSegmentos | 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
- DMANFATINOV-2111
- DMANFATINOV-2114
- DMANFATINOV-2113
- DMANFATINOV-2172
- DMANFATINOV-2208
- DMANFATINOV-2239
|
|---|
02. SITUAÇÃO/REQUISITO
03. SOLUÇÃO
...
| Totvs custom tabs box |
|---|
| tabs | API invoicePublic,Tela exportação,Tela Importação,FT4001/FT4002 - Data base duplicata,FT0904B - Aba duplicata,FT0502, Tela Atualização Títulos |
|---|
| ids | tab1,tab2,tab3,tab4,tab5,tab6,tab7 |
|---|
|
| Totvs custom tabs box items |
|---|
| 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: | Informações |
|---|
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: | Informações |
|---|
{
"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 chave da nota fiscal (tabela nota-fiscal), e os campos dt-entr-cli e a hr-entr-cli já atualizados.  Image Removed Image Added
|
| Totvs custom tabs box items |
|---|
| 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;
| Bloco de código |
|---|
| language | sql |
|---|
| theme | RDark |
|---|
| title | Conteúdo do arquivo gerado |
|---|
| linenumbers | true |
|---|
| 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: | View file |
|---|
| name | exemplo_arquivo _gerado.csv |
|---|
| height | 250 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| 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:
- Hora da entrega (nota-fiscal.hr-entr-cli) formato aceito:
| Informações |
|---|
| Para Notas geradas a partir de um pedido de e-commerce ao alterar a data de entrega também é realizado a atualização dos títulos no ACR, atualizando as datas de vencimentos com base na nova data de entrega. |
Registros com dados/formato inválido não serão atualizados. | Bloco de código |
|---|
| language | sql |
|---|
| theme | RDark |
|---|
| title | Conteúdo do arquivo a ser importado |
|---|
| linenumbers | true |
|---|
| 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 |
|
| Totvs custom tabs box items |
|---|
| 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) 
|
| Totvs custom tabs box items |
|---|
| 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) 
|
| Totvs custom tabs box items |
|---|
| Alterado programa FT0502 - Manutenção Notas Fiscais, agora para notas fiscais feitas a partir de um pedido e-commerce ao alterar a "Dt Entrega Real" e salvar o registro é feito a integração com o ACR, alterando a data do título com base na nova data inserida. | Informações |
|---|
OBS: Para que a integração do ACR seja feita é necessário que a data tenha sido alterada e que seja uma data valida. Ao salvar o registro caso a integração com ACR retorne erro uma mensagem ira aparecer em tela, descrevendo o erro, porem o registro será salvo com a nova data de entrega, caso deseje tentar integrar com o ACR novamente pelo FT0502 um a nova data precisara ser informada. |
|
| Totvs custom tabs box items |
|---|
| Tela Atualização Título Contas a Receber pela Data de entrega Image Added
Criado nova tela de atualização de títulos no contas a receber pela data de entrega de acordo com os filtros informados em tela. |
|
04. DEMAIS INFORMAÇÕES
Documento de referência - Exportação/Importação Data de entrega Efetiva
...
