Histórico da Página

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Criar API rest para envio das notas fiscais de venda e status de fardos para a API rest de beneficiamento externodo sistema Totvs Agro Beneficiamento.

03. SOLUÇÃO

Criado API REST na rotina OGI250B, a qual lê os fardos que estão em romaneio de venda já faturado, gerando o json para integração e realizando a intregração no endpoint externo.A URL de integração ao beneficiamento externo é definida na rotina de Integracao Agro (AGRA080), e o path é fixo em /v1/blocagens/notaFiscal.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

• DT - Criar configurações Configurações para integrar com Beneficiamento