01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Criar API do Tipo Post para enviar o Json com a informações para geração de insumos para ordem serviço no app.

03. SOLUÇÃO

Foi criada a API no seguinte end point:/GERAINSU

Parâmetros de entrada:

• •    "cnpj_empresa":"53485215000106", -  Cnpj da empresa cadastrada no Protheus - SIGAMAT.
       "num_os": "002228",, -ordem de serviço enviado no APP, O.S cadastado no Protheus
        "TipoInsumo": "P", - Tipo de insumo - F=Ferramenta;M=Mão de Obra;P=Produto;T=Terceiro;E=Especialidade
        "CodInsumo": "PROD_MNT_0001", - Código do insumo cadastrado no Protheus
        "Qtd": "10", - Quantidade do Insumo
        "VlrUnit": "50.0", - Valor Unitário do Insumo
        "VlrTotal": "500.0", - Valor Total do Insumo
        "Destino": "A", - Destino do Insumo - A=Apoio
        "CodForn": "FORN001", - Código do Fornecedor do insumo
        "LojForn": "001", - Loja do Fornecedor do insumo
        "NomeForn": "Fornecedor Exemplo", - Nome do Fornecedor do insumo
        "Stapro": "2", Status de Aprovação - 1=PENDENTE;2=APROVADO;3=REPROVADO
        "CodApr": "00001", - Código do Aprovador
        "NomApr": "Aprovador", - Nome do Aprovador
        "DtApro": "2025-05-15", - Data da aprovação
        "HrApro": "09:00", - Hora da Aprovação
        "DtEnc": "2025-05-15", - Data de encerramento da Ordem de serviço
        "HrEnc": "09:00", - Hora de encerramento da Ordem de serviço
        "PedCom": "999999", - Código do Pedido de Compra
        "VlUnApr": "50.0", - Valor Aprovado
        "VlTotApr": "500.0", - Valor Total Aprovado
        "CusExtra": "500.0", - Custo extra do insumo
        "Cobra": "S", - Se cobra o custo extra - S=SIM, N=NÃO
        "CodFinGer": "000001", - Código Finalidade Gerencial 
        "DesFinGer": "TESTE", - Descrição Finalidade Gerencial
        "Justificativa": "Motivo da inclusão",

Json recebido do app para os insumos da Ordem de Serviço:

{
  "cnpj_empresa": "53485215000106",
  "num_os": "002228",
  "Itens": [
    {
      "TipoInsumo": "P",
      "CodInsumo": "PROD_MNT_0001",
      "Qtd": "10",
      "VlrUnit": "50.0",
      "VlrTotal": "500.0",
      "Destino": "A",
      "CodForn": "FORN001",
      "LojForn": "001",
      "NomeForn": "Fornecedor Exemplo",
      "Stapro": "2",
      "CodApr": "00001",
      "NomApr": "A",
      "DtApro": "2025-05-15",
      "HrApro": "09:00",
      "DtEnc": "2025-05-15",
      "HrEnc": "09:00",
      "PedCom": "999999",
      "VlUnApr": "50.0",
      "VlTotApr": "500.0",
      "CusExtra": "500.0",
      "Cobra": "S",
      "CodFinGer": "000001",
      "DesFinGer": "TESTE",
      "Justificativa": "Motivo da inclusao",
      "Anexos": [
        {
          "name": "anexo_item1.jpg",
          "size": "25600",
          "base64": "base64string"
        },
        {
          "name": "anexo2_item1.jpg",
          "size": "25600",
          "base64": "base64string"
        }        
      ]
    }
  ]
}

Retorno esperado:
Response:

{
   "Retorno": "OK",
   "NumOs": "002228"
}

04. DEMAIS INFORMAÇÕES

Tabela envolvida STL - DETALHES DA ORDEM DE SERVIÇO

                            FH1 - INSUMOS MTBF RENTAL

05. ASSUNTOS RELACIONADOS

Apps RENTAL