Órdenes de producción: gestión completa en A3ERP

Los endpoints de órdenes de producción te ofrecen gestión completa del ciclo de vida de las órdenes de fabricación en A3ERP, incluyendo sus líneas, fases y registros de fabricación. Con esta API puedes automatizar la creación de órdenes, actualizar sus cabeceras, controlar costes y eliminar documentos sin necesidad de acceder al ERP directamente.

GET
POST
PUT
DELETE

Recupera todas las órdenes de producción

Devuelve todas las órdenes de producción con los componentes asociados a cada una.

GET /api/ordenproduccion

string

required

Bearer + JWT_token

Ejemplo de respuesta:

{
  "Documentos": [
    {
      "IdProd": "10060",
      "codalmcon": "       1",
      "almacencon": "Productos acabados (central)",
      "codalmfab": "       1",
      "almacenfab": "Productos acabados (central)",
      "codcli": "text",
      "nomcli": "text",
      "fecha": "",
      "tipocont": "",
      "numdoc": "",
      "referencia": "text",
      "situacion": "A",
      "tipostock": "S",
      "Lineas": [
        {
          "idprod": "",
          "idlinp": "",
          "idpadre": "",
          "codalmcon": "",
          "codalmfab": "",
          "codartc": "",
          "descartc": "",
          "idfase": "0",
          "nomfase": "",
          "prcmedio": "",
          "unidadesp": "",
          "terminadoc": "",
          "terminadof": "",
          "unidadesa": "",
          "unidadesf": "",
          "unidadesc": "",
          "uniheredadas": ""
        }
      ]
    }
  ]
}

Recupera una orden de producción concreta

Devuelve la orden de producción identificada por {idprod}.

GET /api/ordenproduccion/{idprod}

Ejemplo: /api/ordenproduccion/10060

string

required

Identificador de la orden de producción.

string

required

Bearer + JWT_token

Filtra órdenes de producción

Devuelve las órdenes que cumplen la condición del filtro indicado.

GET /api/ordenproduccion/filtro/{filtro}

Ejemplo: /api/ordenproduccion/filtro/nomcli='SPORTIF, S.A.'

string

required

Condición de filtrado a aplicar sobre los campos de la orden.

string

required

Bearer + JWT_token

Recupera todas las órdenes ordenadas

Devuelve todas las órdenes de producción ordenadas por el atributo indicado.

GET /api/ordenproduccion/order/{orden}

Ejemplo: /api/ordenproduccion/order/codcli

string

required

Atributo por el que se ordenarán los resultados (p. ej. codcli, fecha).

string

required

Bearer + JWT_token

Filtra y ordena órdenes de producción

Devuelve las órdenes que cumplen el filtro y las ordena por el atributo indicado.

GET /api/ordenproduccion/filtro/{filtro}/orden/{orden}

Ejemplo: /api/ordenproduccion/filtro/codcli=' 1'/orden/codalmcon

string

required

Condición de filtrado a aplicar.

string

required

Atributo por el que se ordenarán los resultados.

string

required

Bearer + JWT_token

Fabricaciones de una orden

Devuelve todas las fabricaciones asociadas a una orden de producción.

GET /api/ordenproduccion/fabricacion/idprod/{idprod}

Ejemplo: /api/ordenproduccion/fabricacion/idprod/10127

string

required

Identificador de la orden de producción.

string

required

Bearer + JWT_token

Ejemplo de respuesta:

{
  "Operaciones": [
    {
      "descripcion": "",
      "idlogp": "",
      "idtrab": "",
      "motivo": "",
      "codlog": "",
      "tipostock": "S",
      "fecha": "",
      "Fabricaciones": [
        {
          "idlinp": "",
          "numlin": "",
          "idlinc": "",
          "codartc": "",
          "descartc": "",
          "feccaduc": "",
          "unidadesfabricadas": "",
          "unidadesprevistas": "",
          "unidadesconsumidas": "text",
          "unidadesprevistastotal": "",
          "tiempoprevistoconsumir": "0:00:00",
          "tiempoconsumido": "0:00:00",
          "tiempoprevistototal": "0:00:01",
          "codalm": "       1",
          "descalm": "Productos acabados (central)",
          "Consumos": [
            {
              "idlinp": "",
              "numlin": "",
              "fase": "",
              "nomfase": "",
              "idlinc": "",
              "codarct": "",
              "descartc": "",
              "feccaduc": "",
              "unidadesfabricadas": "",
              "unidadesprevistas": "",
              "unidadesconsumidas": "",
              "unidadesprevistastotal": "",
              "tiempoprevistoconsumir": "0:00:00",
              "tiempoconsumido": "0:00:00",
              "tiempoprevistototal": "0:00:01",
              "codalm": "       1",
              "descalm": "Productos acabados (central)"
            }
          ]
        }
      ]
    }
  ]
}

Fabricaciones de un trabajo concreto

Devuelve las fabricaciones asociadas a un trabajo específico dentro de una orden de producción.

GET /api/ordenproduccion/fabricacion/idprod/{idprod}/idtrab/{idtrab}

Ejemplo: /api/ordenproduccion/fabricacion/idprod/10127/idtrab/1

string

required

Identificador de la orden de producción.

string

required

Identificador del trabajo.

string

required

Bearer + JWT_token

Fases de una orden

Devuelve todas las fases de la orden de producción indicada.

GET /api/ordenproduccion/fase/idprod/{idprod}

Ejemplo: /api/ordenproduccion/fase/idprod/10060

string

required

Identificador de la orden de producción.

string

required

Bearer + JWT_token

Campos de respuesta:

integer

Identificador de la orden de producción.

integer

Identificador de la fase.

integer

Identificador de la línea de producción.

string

Código del artículo.

string

Descripción del artículo.

string

Código identificador de la fase.

string

Nombre de la fase.

string

Tiempo previsto.

string

Tiempo terminado.

string

Tiempo consumido.

string

Tiempo previsto total.

Fases de una orden filtradas

Devuelve las fases de una orden de producción que cumplen la condición del filtro.

GET /api/ordenproduccion/fase/idprod/{idprod}/filtro/{filtro}

Ejemplo: /api/ordenproduccion/fase/idprod/10100/filtro/codart=' 31'

string

required

Identificador de la orden de producción.

string

required

Condición de filtrado a aplicar sobre los campos de la fase.

string

required

Bearer + JWT_token

Actualizar costes de componentes

Recalcula los costes de todos los componentes de la orden con los precios actuales. Este endpoint sólo afecta a la orden indicada; no actualiza la estructura del artículo en el catálogo general.

GET /api/ordenproduccion/actualizarcostes/idprod/{idprod}

Ejemplo: /api/ordenproduccion/actualizarcostes/idprod/10100

string

required

Identificador de la orden de producción.

string

required

Bearer + JWT_token

Este endpoint actualiza los costes únicamente para la orden especificada. La estructura del artículo en el maestro de artículos no se modifica.

Crear una orden de producción

Crea una nueva orden de producción con los productos, fases, máquinas, operarios y componentes que le indiques en el cuerpo de la petición.

POST /api/ordenproduccion

string

required

Bearer + JWT_token

Cuerpo de la petición:

{
  "json": {
    "fecha": "text",
    "codalmcon": "text",
    "codcli": "text",
    "productos": [
      {
        "codartc": "text",
        "unidades": "text",
        "fases": [
          {
            "fase": "text",
            "nomfase": "text",
            "maquinas": [
              {
                "perfilmaq": "text",
                "tiempop": "text",
                "codmaq": "text"
              }
            ],
            "operarios": [
              {
                "perfilper": "text",
                "tiempoP": "text",
                "codemp": "text"
              }
            ],
            "componentes": [
              {
                "codartc": "text",
                "unidades": "text",
                "codalmcon": "text",
                "final": "text"
              }
            ]
          }
        ]
      }
    ]
  }
}

string

Fecha de la orden de producción.

string

Código del almacén de consumo.

string

Código del cliente asociado a la orden.

array

Lista de productos acabados que se fabricarán en la orden.

string

Código del artículo a fabricar.

string

Número de unidades a fabricar.

array

Fases de producción del artículo.

string

Código identificador de la fase.

string

Nombre descriptivo de la fase.

array

Máquinas asignadas a la fase.

array

Operarios asignados a la fase.

array

Componentes necesarios para la fase.

Respuesta exitosa:

{
  "Codigo": 1
}

Añadir una fase a una orden

Añade una nueva fase a un producto dentro de una orden de producción existente.

POST /api/ordenproduccion/fase/idprod/{idprod}/idlin/{idlin}/fase/{fase}/nomfase/{nomfase}

Ejemplo: /api/ordenproduccion/fase/idprod/10109/idlin/11817/fase/PI/nomfase/Pintar API

string

required

Identificador de la orden de producción.

string

required

Debe ser el idlinp de la línea con el producto al que se quiere añadir la fase.

string

required

Código identificador de la fase a añadir.

string

required

Nombre de la fase a añadir.

string

required

Bearer + JWT_token

Respuesta exitosa:

{
  "IdLin": "text"
}

El valor devuelto en IdLin se corresponde con el campo idlinp al consultar las fases de la orden mediante GET.

Modificar la cabecera de una orden

Actualiza los campos de la cabecera de la orden de producción indicada.

PUT /api/ordenproduccion/{idprod}

Ejemplo: /api/ordenproduccion/10111

string

required

Identificador de la orden de producción a modificar.

string

required

Bearer + JWT_token

Cuerpo de la petición:

{
  "json": {
    "fecha": "text",
    "codcli": "text"
  }
}

string

Nueva fecha de la orden de producción.

string

Nuevo código de cliente asociado a la orden.

Modificar una línea de una orden

Actualiza los datos de una línea concreta dentro de una orden de producción.

PUT /api/ordenproduccion/{idprod}/linea/{idlinea}

Ejemplo: /api/ordenproduccion/10074/linea/11471

string

required

Identificador de la orden de producción a modificar.

string

required

Identificador de la línea a modificar.

string

required

Bearer + JWT_token

Cuerpo de la petición:

{
  "json": {
    "codemp": "text",
    "costefijo": "text"
  }
}

string

Código del empleado asignado a la línea.

string

Coste fijo asignado a la línea.

Eliminar una orden de producción completa

Elimina la orden de producción y todas sus líneas asociadas.

DELETE /api/ordenproduccion/{idprod}

Ejemplo: /api/ordenproduccion/10111

string

required

Identificador de la orden de producción a eliminar.

string

required

Bearer + JWT_token

Esta operación es irreversible. Elimina la orden completa junto con todas sus líneas, fases y fabricaciones asociadas.

Eliminar una línea de una orden

Elimina una línea específica de la orden de producción indicada.

DELETE /api/ordenproduccion/{idprod}/linea/{idlinea}

Ejemplo: /api/ordenproduccion/10111/linea/11835

string

required

Identificador de la orden de producción.

string

required

Identificador de la línea a eliminar.

string

required

Bearer + JWT_token

Fundamentos

Maestros y Documentos

Stock e Inventario

Informes y Datos

Producción

Módulos Adicionales

Contabilidad

Órdenes de producción: gestión completa en A3ERP

Recupera todas las órdenes de producción

Recupera una orden de producción concreta

Filtra órdenes de producción

Recupera todas las órdenes ordenadas

Filtra y ordena órdenes de producción

Fabricaciones de una orden

Fabricaciones de un trabajo concreto

Fases de una orden

Fases de una orden filtradas

Actualizar costes de componentes

Crear una orden de producción

Añadir una fase a una orden

Modificar la cabecera de una orden

Modificar una línea de una orden

Eliminar una orden de producción completa

Eliminar una línea de una orden