01. DADOS GERAIS
| 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
|
|---|
|
|
|---|
02. SITUAÇÃO/REQUISITO
03. SOLUÇÃO
...
| Totvs custom tabs box |
|---|
| tabs | API invoicePublic,Tela exportação,Tela Importação,Agrupar Pedido no Embarque |
|---|
| ids | tab1,tab2,tab3,tab4 |
|---|
|
| 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 nota fiscal completa (tabela nota-fiscal), contendo a dt-entr-cli e a hr-entr-cli já atualizadas. 
|
| 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:
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 |
|---|
| Pedidos feitos para e-commerce podem ou não ser agrupados em um mesmo resumo do embarque, dependendo do parâmetro marcado na central de configurações do e-commerce (html.ecommerceConf).  Image Added
Caso o parâmetro de "Data base para o vencimento dos títulos de E-commerce" esteja marcado como "Data Emissão Nota Fiscal" o pedido será agrupado com outros pedidos que tenham o mesmo parâmetro OU com pedidos que não são do e-commerce, porem caso esteja marcado "Data Previsão Entrega" o pedido somente será agrupado com outros pedidos do e-commerce que tenham sido criados com o mesmo parâmetro.  Image Addedaaaa
|
|
04. DEMAIS INFORMAÇÕES
Documento de referência - Exportação/Importação Data de entrega Efetiva
...
