Registro 1004

Registro 1004 refere-se ao envio de Ordens de Serviço (OS) via requisição POST para o seguinte endpoint:

http://ip_servidor/1004

Esta documentação detalha os campos esperados no envio, um exemplo completo em JSON e os possíveis retornos da API.

🔎 Resumo Rápido

Método: POST
Endpoint: http://ip_servidor/1004
Resposta esperada: JSON com status ou mensagem de erro

1. Envio de Dados

A requisição deve conter um JSON com os dados da OS.

📦 Campos esperados no JSON principal:

Campo	Descrição	Tipo
codigo	Código da OS	inteiro, string
quantidade_tecido	Quantidade de tecido em Kg	inteiro, float, string
relacao_banho	Realação de banho	inteiro, float, string
absorcao	Absorção	inteiro, float, string
executar	Para executar sem confirmação do operador true	booleano
tempo_corda	Tempo de corda esperado	string
info	JSON com informações da os	objeto{}
programas	Array de objetos com os programas	array[]

Estrutura dos produtos (dentro de `info`):

Campo	Descrição	Tipo
cliente	Cliente da OS	string
artigo	Artigo da OS	string
proxima_os	Próxima OS a ser executada	string
observacao	Observação sobre a OS	string

Estrutura dos programas (dentro de `programas`):

Campo	Descrição	Tipo
codigo	Código do programa	string
nome	Nome do programa	string
passos	Array de objetos com os passos	array[]

Estrutura dos passos (dentro de `passos`):

Campo	Descrição	Tipo
sequencia	Sequência do passo	inteiro, string
codigo	Código da função	string
parametro1	Valor para parâmetro 1, vazio se não possuir valor	inteiro, string
parametro2	Valor para parâmetro 2, vazio se não possuir valor	inteiro, string
parametro3	Valor para parâmetro 3, vazio se não possuir valor	inteiro, string
parametro4	Valor para parâmetro 4, vazio se não possuir valor	inteiro, string
parametro5	Valor para parâmetro 5, vazio se não possuir valor	inteiro, string
parametro6	Valor para parâmetro 6, vazio se não possuir valor	inteiro, string
parametro7	Valor para parâmetro 7, vazio se não possuir valor	inteiro, string
parametro8	Valor para parâmetro 8, vazio se não possuir valor	inteiro, string
parametro9	Valor para parâmetro 9, vazio se não possuir valor	inteiro, string
produtos	Se for uma chamada de produto, pode ser enviado a lista	array[]

Estrutura dos produtos (dentro de `produtos`):

Index	Descrição	Tipo
0	Descrição do Produto, com código, nome, quantidade e tipo	string
1	Tipo de Envio, 0=manual, 1=automático	inteiro

✅ Exemplo de envio (JSON)

{
  "codigo": "1443581",
  "quantidade_tecido": "273",
  "relacao_banho": "12",
  "absorcao": "2",
  "executar": 0,
  "tempo_corda": "0",
  "info": {
    "cliente": "COMERCIAL DE ELASTICOS E TECIDOS LTDA",
    "artigo": "POLIAMIDA",
    "proxima_os": "",
    "observacao": ""
  },
  "programas": [
    {
      "codigo": "133",
      "nome": "133 - POLIAMIDA TURQUESA COR ESC.",
      "passos": [
        {
          "sequencia": "1",
          "codigo": "27",
          "parametro1": "1",
          "parametro2": "2",
          "parametro3": "",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "2",
          "codigo": "20",
          "parametro1": "2",
          "parametro2": "0",
          "parametro3": "0",
          "parametro4": "50",
          "parametro5": 0,
          "parametro6": 0,
          "parametro7": 0,
          "parametro8": 1,
          "parametro9": ""
        },
        {
          "sequencia": "3",
          "codigo": "9",
          "parametro1": "0",
          "parametro2": "3276",
          "parametro3": 0,
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "4",
          "codigo": "16",
          "parametro1": 74,
          "parametro2": "",
          "parametro3": "",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "5",
          "codigo": "17",
          "parametro1": 73,
          "parametro2": "",
          "parametro3": "",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "6",
          "codigo": "2",
          "parametro1": "",
          "parametro2": "",
          "parametro3": "",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "7",
          "codigo": "32",
          "parametro1": "",
          "parametro2": "",
          "parametro3": "",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": ""
        },
        {
          "sequencia": "8",
          "codigo": "24",
          "parametro1": "2",
          "parametro2": "1",
          "parametro3": "1",
          "parametro4": "",
          "parametro5": "",
          "parametro6": "",
          "parametro7": "",
          "parametro8": "",
          "parametro9": "",
          "produtos": [
            [
              "BARRILHA OU CARBONATO DE SODIO - Qtde: 655,20gr - Dosagem manual",
              0
            ]
          ]
        },
      ]
    }
  ]
}

2. Respostas da API

🔄 Sucesso – HTTP 200

Se os dados forem entregues corretamente, será retornado o status code 200 com o ID de integração da OS no campo status.

{
  "status": 1502,

}

❌ Erro de validação – HTTP 400

Se houver erros nos dados enviados, será retornado o status code 400 com o erro descrito no campo erro:

{
  "erros": "Controlador já em execução, tentativa de envio de OS negada"
}