Integraciones Órdenes de Producción

Recursos para pruebas

Para facilitar la integración y las pruebas de los webhooks de Business Central, está disponible un espacio de trabajo en Postman. Esto permite interactuar con la API sin necesidad de desarrollar código de cliente de manera inmediata.

Business Central (Integración Producción)

Integración de órdenes de producción

Estructura básica

{
    "prodOrder": "PROD001",
    "prodOrderExt": "PRODEXT001",
    "locationCode": "MP",
    "type": "PBA"
    "tag": "13244234",
    "productionOrderlines":[
        {
            "itemNoExt": "PTCM10",
            "unitMeasureCode": "KG",
            "quantity": 10,
            "finishedQuantity": 10,
            "productionOrderComponents":[
                {
                    "itemNoExt":"MP003",
                    "unitMeasureCode": "KG",
                    "estimatedquantityPer": 1,
                    "realquantityPer": 3
                }
            ]
        }
    ]
}

Campos de la integración

Encabezado

Campo	Tipo de dato	Descripción
prodOrder	Text	Nro. de orden de producción.
prodOrderExt	Text	Nro. de orden de producción externa.
locationCode	Text[255]	Código de ubicación.
lote	Text[20]	Nro. de lote.

Líneas

Campo	Tipo de dato	Descripción
itemNoExt	Text[255]	Código del artículo externo
unitMeasureCode	Text[255]	Código de la unidad de medida
quantity	Decimal	Cantidad del artículo
finishedQuantity	Decimal	Cantidad finalizada

Componentes

Campo	Tipo de dato	Descripción
itemNoExt	Text	Código del artículo externo.
unitMeasureCode	Text	Código de la unidad de medida.
estimatedquantityPer	Decimal	Cantidad estimada por unidad
realquantityPer	Decimal	Cantidad real por unidad

Creación de tickets de producción (ABA)

Las ordenes de produccion provenientes de ABA provienen de una orden de produccion externa, por lo que se debe enviar el campo prodOrderExt con el valor de la orden de produccion externa. Y asociarse a la orden de produccion interna que se genere en Business Central, la cual se enviara en el campo prodOrder. Los componentes de la orden de produccion se deben enviar en la propiedad productionOrderComponents.

Para crear tickets de producción se debe utilizar la siguiente estructura:

POST
https://devnamespacevog.servicebus.windows.net
Header{
  Content-Type: application/json
  Authorization: Bearer {SharedAccessSignature}
  companyID: {companyID} // Id de la compañía en Business Central
  environment: {environment} // Nombre del ambiente en Business Central
  operationType: "POST" // Tipo de operación
  requestId: {requestId} // Id del mensaje
}
body
{
    "prodOrder": "OPL001",
    "prodOrderExt": "PROD0004",
    "type": "ABA",
    "productionOrderlines":[
        {
            "itemNoExt": "PTCM10",
            "unitMeasureCode": "UND",
            "quantity": 10,
            "finishedQuantity": 10,
            "productionOrderComponents":[
                {
                    "itemNoExt":"mp003",
                    "unitMeasureCode": "KG",
                    "estimatedquantityPer": 1,
                    "realquantityPer": 3
                }
            ]
        }
    ]
}

Datos Obtenidos

{
    "@odata.etag": "W/\"JzE5OzQ0OTgzNDcwMzEwMjk4OTg5MDkxOzAwOyc=\"",
    "id": "7c4c62ef-a587-f111-8072-002248360983",
    "prodOrderID": 1,
    "prodOrder": "F-OPL0236",
    "prodOrderExt": "PRODEXT001",
    "locationCode": "ALMACEN 2",
    "tag": "",
    "date": "2026-07-24T21:23:39.087Z",
    "modifiedAt": "2026-07-24T21:23:39.093Z",
    "productionOrderlines": [
        {
            "@odata.etag": "W/\"JzIwOzExNzA0ODA3NTk1NDUzNjQyMTQ3MTswMDsn\"",
            "id": "7d4c62ef-a587-f111-8072-002248360983",
            "productionOrderNo": "F-OPL0236",
            "lineNo": 10000,
            "itemNoExt": "PTCM10",
            "itemNo": "PTCM01001",
            "description": "Pollo Beneficiado Grado A Embolsado F",
            "unitMeasureCode": "KG",
            "quantity": 10,
            "finishedQuantity": 10,
            "systemModifiedAt": "2026-07-24T21:23:39.17Z",
            "productionOrderComponents":[
                {
                    "itemNoExt":"mp003",
                    "unitMeasureCode": "KG",
                    "estimatedquantityPer": 1,
                    "realquantityPer": 3
                }
            ]
        }
    ]
},

Encabezado

Campo	Tipo de dato	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
prodOrderID	Integer	El ID interno de la orden de producción.
prodOrder	Text[20]	Código de la orden de producción.
prodOrderExt	Text[20]	Código de la orden de producción externa.
locationCode	Text[20]	Código de ubicación.
tag	Text[20]	Código de etiqueta.
date	DateTime	Fecha de creación del registro.
modifiedAt	DateTime	Fecha de modificación del registro.

Lineas

Campo	Tipo de dato	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
productionOrderNo	Text[20]	Código de la orden de producción.

Creación de tickets de producción (PBA)

Las ordenes de produccion provienen de una produccion ABA, y se registrar como recibo de produccion parcial bajo una orden de produccion interna, por lo que se debe enviar el campo prodOrder con el valor de la orden de produccion interna.

{
    "@odata.etag": "W/\"JzE5OzQ0OTgzNDcwMzEwMjk4OTg5MDkxOzAwOyc=\"",
    "id": "7c4c62ef-a587-f111-8072-002248360983",
    "prodOrderID": 1,
    "type": "PBA",
    "prodOrder": "F-OPL0236",
    "locationCode": "ALMACEN 2",
    "tag": "12434",
    "date": "2026-07-24T21:23:39.087Z",
    "modifiedAt": "2026-07-24T21:23:39.093Z",
    "productionOrderlines": [
        {
            "@odata.etag": "W/\"JzIwOzExNzA0ODA3NTk1NDUzNjQyMTQ3MTswMDsn\"",
            "id": "7d4c62ef-a587-f111-8072-002248360983",
            "productionOrderNo": "F-OPL0236",
            "lineNo": 10000,
            "itemNoExt": "PTCM10",
            "itemNo": "PTCM01001",
            "description": "Pollo Beneficiado Grado A Embolsado F",
            "unitMeasureCode": "KG",
            "quantity": 10,
            "finishedQuantity": 10,
            "systemModifiedAt": "2026-07-24T21:23:39.17Z"
        }
    ]
},

Datos Obtenidos

Encabezado

Campo	Tipo de dato	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
prodOrderID	Integer	El ID interno de la orden de producción.
prodOrder	Text[20]	Código de la orden de producción.
locationCode	Text[20]	Código de ubicación.
tag	Text[20]	Código de etiqueta.
date	DateTime	Fecha de creación del registro.
modifiedAt	DateTime	Fecha de modificación del registro.

Lineas

Campo	Tipo de dato	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
productionOrderNo	Text[20]	Código de la orden de producción.
lineNo	Integer	Número de línea.
itemNoExt	Text[20]	Código externo del artículo.
itemNo	Text[20]	Código del artículo.
description	Text[100]	Descripción del artículo.
unitMeasureCode	Text[10]	Código de unidad de medida.
quantity	Decimal(18,2)	Cantidad del artículo.
finishedQuantity	Decimal(18,2)	Cantidad terminada del artículo.
systemModifiedAt	DateTime	Fecha de modificación del registro.

Consumo de maestros de datos

Consumo de órdenes de producción

Obtener lista de órdenes de producción

Consumir endpoints

Para consultar manualmente las órdenes de producción, puedes consumir el endpoint personalizado de Business Central.

GET
https://api.businesscentral.dynamics.com/v2.0/{{TenantID}}/{{environmentName}}/api/virtualOfficeGroup/integration/v1.0/companies({{companyId}})/prodOrders?$expand=prodOrderLines
Content-Type: application/json
Authorization: Bearer {access_token}

Datos obtenidos

{
    "@odata.etag": "W/\"JzE5OzM3MDAwNDA0MTM0NjI1MDI1NjAxOzAwOyc=\"",
    "id": "0f5b4ba5-9074-f111-8070-002248360983",
    "status": "Released",
    "code": "F-OPL0237",
    "description": "Pechuga de Pollo Punta de Monte 1Und * 800gr",
    "description2": "",
    "sourceType": "Item",
    "sourceNo": "PTCM10021",
    "dueDate": "2026-07-01",
    "systemModifiedAt": "2026-06-30T14:33:25.2Z",
    "prodOrderLines": [
        {
            "@odata.etag": "W/\"JzIwOzEzMDkzODA3OTgyNTU5MTYzMzE4MTswMDsn\"",
            "id": "105b4ba5-9074-f111-8070-002248360983",
            "lineNo": 10000,
            "itermNo": "PTCM10021",
            "description": "Pechuga de Pollo Punta de Monte 1Und * 800gr",
            "description2": "",
            "unitMeasureCode": "UND",
            "quantity": 100,
            "remainingQuantity": 100,
            "finishedQuantity": 0,
            "systemModifiedAt": "2026-06-30T14:33:24.58Z"
        }
    ]
}

Campos de la respuesta (Encabezado)

Nombre	Tipo	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
status	Text[20]	Estado del documento.
code	Text[20]	Código de la orden de producción.
description	Text[100]	Descripción de la orden de producción.
description2	Text[50]	Descripción secundaria de la orden de producción.
sourceType	Text[20]	Tipo de fuente de la orden de producción.
sourceNo	Text[20]	Número de fuente de la orden de producción.
dueDate	Date	Fecha límite de entrega de la orden.
systemModifiedAt	DateTime	Sello de tiempo de la última edición.

Campos de la respuesta (Líneas)

Nombre	Tipo	Descripción
@odata.etag	String	Un identificador de versión del registro (concurrencia).
id	Guid	El GUID (Identificador Único Global) interno de Business Central.
lineNo	Integer	Número de línea de la orden de producción.
itemNo	Text[20]	Número de artículo de la orden de producción.
description	Text[100]	Descripción del artículo de la orden de producción.
description2	Text[50]	Descripción secundaria del artículo de la orden de producción.
unitMeasureCode	Text[10]	Código de la unidad de medida del artículo.
quantity	Decimal	Cantidad solicitada del artículo.
remainingQuantity	Decimal	Cantidad restante del artículo.
finishedQuantity	Decimal	Cantidad finalizada del artículo.
systemModifiedAt	DateTime	Sello de tiempo de la última edición.