01. DADOS GERAIS
Produto: | TOTVS Agro Beneficiamento
|
---|---|
Linha de Produto: | Linha Protheus |
Segmento: | Agroindústria |
Módulo: | BENEFICIAMENTO |
Função: | ENCERRAMENTO DE FARDÃO(AGRA620) |
Ticket: | |
Requisito/Story/Issue (informe o requisito relacionado) : | DAGROINDUSTRIA-13166 |
02. SITUAÇÃO/REQUISITO
Criar API REST para reporte de produção do beneficiamento de algodão realizado via sistema externo.
03. SOLUÇÃO
Criado API REST no AGRO no endpoint ubaw150/v1/productionreport/ para recebimento do JSon e geração do reporte de produção no Protheus.
Esta integração via atender o reporte de produção para produtos sem estrutura no Protheus, sendo necessário gerar movimentações de requisição e/ou devolução relacionados ao reporte de ordem de produção. Estas movimentações deverão ser enviados na TAG <listOfSupplyOrders>, sendo que para os produtos de requisição a quantidade deve ser positiva e para os produtos de devolução a quantidade deve ser negativa no JSon.
No Protheus os campo D3_DOC e D3_OP destes movimentos serão os mesmos da produção. No sucesso da integração, no jSon de retorno será enviado o id do reporte do movimento da produção sendo este D3_FILIAL+D3_COD+D3_LOCAL+D3_NUMSEQ para gravação na API externa e posteriormente permitir o estorno.
Para registrar os fardinhos de algodão na tabela de fardinhos do AGRO, DXI, para posterior uso na comercialização é necessário enviar os fardinhos com os dados necessários na TAG <listOfBales>.
Abaixo segue exmplo do Json de recebimento pela API no Protheus.
{
"productionOrderNumber":"pcpBG601001",
"companyId":"",
"branchID":"",
"reportQuantity":217.5,
"reportDateTime":"2024-02-29T07:14:28Z",
"reversedReport":false,
"lotCode":"CLAUA00401",
"outflowWarehouseCode":"01",
"outflowLocationCode":null,
"movimentType":"002",
"part_total":"T",
"lotDueDate":"2024-02-29",
"listOfSupplyOrders":[
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGR-ARAME-ENFARDAMENTO-ALGODAO",
"usedQuantity":1.12,
"warehouseCode":"01",
"movimentType":"501",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGRO-SACO-ENFARDAR-ALGODAO",
"usedQuantity":1,
"warehouseCode":"01",
"movimentType":"501",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGR-FARDAO-ALGODAO LOTE",
"usedQuantity":543.69,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":"CLAUF00010"
},
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGRO-RESIDUO-DE-ALGODAO",
"usedQuantity":-5.52,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGROALGODAO-CAROCO",
"usedQuantity":-282.15,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBG601001",
"materialCode":"AGRO-FIBRILHA-DE-ALGODAO",
"usedQuantity":-38.52,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null
}
],
"listOfBales":[
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":217.5,
"grossWeight":217.5,
"crop":"2122",
"baleCode":"224011",
"bigBaleCode":"FR0401",
"baleTag":"00078986960910220401",
"reportDateTime":"2024-02-29T09:14:28Z",
"warehouseCode":"01",
"lotCode":"CLAUA00401"
}
]
}
{
"productionOrderNumber":"pcpBGA01001",
"companyId":"",
"branchID":"",
"reportQuantity":4417.5
"reportDateTime":"2024-02-29T11:35:22Z",
"reversedReport":false,
"lotCode":"CLAUA00801",
"outflowWarehouseCode":"01",
"outflowLocationCode":null,
"movimentType":"002",
"part_total":"T",
"lotDueDate":"2024-02-29",
"listOfSupplyOrders":[
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGR-ARAME-ENFARDAMENTO-ALGODAO",
"usedQuantity":24.64,
"warehouseCode":"01",
"movimentType":"501",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGRO-SACO-ENFARDAR-ALGODAO",
"usedQuantity":22,
"warehouseCode":"01",
"movimentType":"501",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGR-FARDAO-ALGODAO LOTE",
"usedQuantity":11961.2,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":"CLAUF00015"
},
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGRO-RESIDUO-DE-ALGODAO",
"usedQuantity":-152.78,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null
},
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGROALGODAO-CAROCO",
"usedQuantity":-6417.41,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null,
"lotDueDate":"2024-02-29"
},
{
"productionOrderNumber":"pcpBGA01001",
"materialCode":"AGRO-FIBRILHA-DE-ALGODAO",
"usedQuantity":-973.501,
"warehouseCode":"01",
"movimentType":"001",
"locationCode":null,
"lotCode":null
}
],
"listOfBales":[
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":"217.5",
"grossWeight":"217.5",
"crop":"2122",
"baleCode":"220801",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220801",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":"200",
"grossWeight":"200",
"crop":"2122",
"baleCode":"220802",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220802",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220304",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220803",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220305",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220805",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220306",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220806",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220307",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220807",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220308",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220808",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220309",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220809",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220310",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220810",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220311",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220811",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220312",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220812",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220313",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220813",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220314",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220814",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220315",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220815",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220316",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220816",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220317",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220817",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
},
{
"branch":"D MG 01",
"materialCode":"AGR-ALGODAO-PLUMA-LOTE",
"netWeight":250,
"grossWeight":250,
"crop":"2122",
"baleCode":"220317",
"bigBaleCode":"FR0801",
"baleTag":"00078986960910220818",
"reportDateTime":"2024-02-29T08:35:22Z",
"warehouseCode":"01",
"lotCode":"CLAUA00801"
}
]
}
04. DEMAIS INFORMAÇÕES
Não se aplica
05. ASSUNTOS RELACIONADOS
DT API para Estorno do Reporte de Produção AGRO