Linha Microsiga Protheus

Árvore de páginas


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.

Exemplo Json

    {
        "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