01. DADOS GERAIS
Produto: | TOTVS Agro Beneficiamento
|
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Agroindústria |
Módulo: | Gestão de Agronegócio |
Função: | OGI250B |
Ticket: | |
Requisito/Story/Issue (informe o requisito relacionado) : | DAGROINDUSTRIA-12176 / DAGROINDUSTRIA-13689 |
02. SITUAÇÃO/REQUISITO
Criar API rest para envio das notas fiscais de venda e status de fardos para a API rest do sistema Totvs Agro Beneficiamento.
03. SOLUÇÃO
Criado a rotina OGI250B que fará a integração com o sistema Totvs Agro beneficiamento, para envio do status do fardo(EMBLOCADO, RESERVADO e ENTREGUE), e quando o fardo estiver sido faturado fará o envio dos dados da NF.
A integração com o endpoint /v1/blocagens/reservar, tratará a atualização do status do fardo para RESERVADO no sistema Totvs Agro Beneficiamento. A integração irá ocorrer para os fardos/etiquetas que tenham sido vinculados em uma reserva/take-up aprovado para um contrato de venda.
A integração com o endpoint /v1/blocagens/reserva/cancelar, tratará a atualização do status do fardo para EMBLOCADO no sistema Totvs Agro Beneficiamento. A integração irá ocorrer para os fardos/etiquetas que tenham tido sua reserva/take-up estornado para um contrato de venda.
A integração com o endpoint /v1/blocagens/notaFiscal, tratará a atualização do status do fardo para ENTREGUE e s inclusão dos dados da Nota Fiscal no sistema Totvs Agro Beneficiamento. A integração irá ocorrer para os fardos/etiquetas que tenham sido faturados(NF) em um romaneio de venda para um contrato de venda.
A integração com o endpoint /v1/blocagens/notaFiscal/cancelar, tratará a atualização do status do fardo para RESERVADO e os dados da NF no sistema Totvs Agro Beneficiamento. A integração irá ocorrer para os fardos/etiquetas vinculados em um romaneio de venda que tenha o faturamento(NF) cancelado.
O controle de envio das integrações acima no Protheus será feito pelos registros gerados na tabela de movimentação de fardos(N9D). O campo N9D_INTEGR fará o controle se a integração ocorreu.
Abaixo segue exemplo do json de envio do Protheus para o endpoint /v1/blocagens/notaFiscal do Totvs Agro Beneficiamento :
[{
"safraERP":"2022",
"etiqueta":"00078986960910678761",
"numeroNF":"99006799",
"serie":"067",
"dataEmissao":"2024-05-07T08:55",
"cnpjEmissao":"78872397000107"
}]
Abaixo segue o json dos demais endpoint mencionados para tratar os status RESERVADO e EMBLOCADO:
[{
"safraERP":"2022",
"etiqueta":"00078986960910678761",
"numeroNF":"",
"serie":"",
"dataEmissao":"",
"cnpjEmissao":""
}]
04. DEMAIS INFORMAÇÕES
Não se aplica
05. ASSUNTOS RELACIONADOS