Modificar órdenes de compra

El punto final PUT /pic/link/purchase-orders/update le permite actualizar las órdenes de compra. 👔💼🤝

Authorización

Este endpoint requiere autenticación a través de Basic Auth con el nombre de usuario y contraseña del backend que lo consumirá. Para crear y configurar un backend, siga el tutorial de backends

Parámetros requeridos

👣 Path

Esta solicitud no contiene parámetros de tipo Path

🔍 Query

Esta solicitud no contiene parámetros de tipo Query

💪 Body

Cuerpo de la solicitud

{
  "inputs": [
    PurchaseOrder
  ]
}

Nombre	Tipo	Por defecto	Descripción
inputs	Array[PurchaseOrder]	Required	Lista de órdenes de compra a crear

---

PurchaseOrder

{
  "header": PurchaseOrderHeader,
  "details": [
    PurchaseOrderItem
  ]
}

Nombre	Tipo	Por defecto	Descripción
header	PurchaseOrderHeader	Required	Datos de cabecera de la orden de compra
details	Array[PurchaseOrderItem]	Required	Lista de puestos de orden de compra

---

PurchaseOrderHeader

{
  "purchaseOrderId": string,
  "purchaseOrderType": PurchaseOrderType,
  "accountingEntityId": string,
  "vendorBusinessPartnerId": string,
  "currencyId": string,
}

Nombre	Tipo	Por defecto	Descripción
purchaseOrderId	string	Required	Identificador de la orden de compra
purchaseOrderType	PurchaseOrderType	Required	Tipo de la orden de compra
accountingEntityId	string	Required	Identificador de la entidad tributaria que procesa la OC
vendorBusinessPartnerId	string	Required	Identificador del socio comercial que proporciona la orden de compra
currencyId	string	Required	Moneda de la orden de compra

---

info

El accountingEntityId y el vendorBusinessPartnerId deben corresponder a la asignación externa de una entidad contable de AppliQloud y un socio comercial.

PurchaseOrderType

Posibles valores: [LOCAL, IMPORT]

---

PurchaseOrderItem

{
  "itemId": string,
  "itemType": PurchaseOrderItemType,
  "ascriptionType": PurchaseOrderAscriptionType,
  "productGroupId": string,
  "productId": string,
  "locationId": string | null,
  "storageId": string | null,
  "requiredDeliveryDate": string | null,
  "quantity": int,
  "unitId": string,
  "netUnitPrice": float
}

Nombre	Tipo	Por defecto	Descripción
itemId	string	Required	Identificador del artículo
itemType	PurchaseOrderItemType	Required	Tipo del artículo
ascriptionType	PurchaseOrderAscriptionType	Required	Tipo de adscripción del artículo
productGroupId	string	Required	Identificador externo del grupo de productos.
productId	string	Required	Identificador externo del producto.
locationId	string | null	null	Identificador externo del lugar de entrega
storageId	string | null	null	Almacenamiento donde se almacenará el producto.
requiredDeliveryDate	string | null	null	Fecha de entrega requerida del artículo.
quantity	int	Required	Cantidad a comprar
unitId	string	false	Unidad de medida de cantidad.
netUnitPrice	float	Required	Precio unitario del producto.

info

El valor ascriptionType INVENTORY solo se permite cuando el valor itemType es GOODS. itemTypes con valor SERVICE debe tener un valor ascriptionType de EXPENSE.

info

Los campos productGroupId, productId y locationId deben corresponder a valores de mapeo externos de un grupo de productos, producto y ubicación de AppliQloud. El campo LocationId es opcional a menos que el campo itemType sea INVENTORY, entonces es obligatorio. Además, el producto al que corresponde el campo productId debe ser parte del grupo de productos al que corresponde el campo productGroupId.

---

PurchaseOrderItemType

Valores posibles: [GOODS, SERVICE]

---

PurchaseOrderAscriptionType

Valores posibles: [INVENTORY, EXPENSE]

Ejemplos

cURL

curl --location 'https://<identifier>.api.appliqloud.com/pic/link/purchase-orders/update' \
--request PUT \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <token>' \
--data '{
    "inputs": [
        {
            "header": {
                "purchaseOrderId": "450000001",
                "purchaseOrderType": "IMPORT",
                "accountingEntityId": "AE1",
                "vendorBusinessPartnerId": "9715",
                "currencyId": "MXN"
            },
            "items": [
                {
                    "itemId": "10",
                    "itemType": "GOODS",
                    "ascriptionType": "EXPENSE",
                    "productGroupId": "1",
                    "productId": "101",
                    "locationId": "MX-LOC",
                    "storageId": "123123",
                    "requiredDeliveryDate": "2024-07-22",
                    "quantity": 1,
                    "unitId": "EA",
                    "netUnitPrice": 6000
                }
            ]
        }
    ]
}'

Respuestas

✅ 200

La orden de compra se actualizó exitosamente.

{
    "success": [
        {
            "header": {
                "purchaseOrderId": "450000001",
                "purchaseOrderStatus": "OPEN",
                "purchaseOrderType": "IMPORT",
                "accountingEntityId": "AE1",
                "vendorBusinessPartnerId": "9715",
                "currencyId": "MXN",
                "netTotalPrice": 6000.0
            },
            "items": [
                {
                    "itemId": "10",
                    "itemType": "GOODS",
                    "ascriptionType": "EXPENSE",
                    "productGroupId": "1",
                    "productId": "101",
                    "locationId": "MX-LOC",
                    "storageId": "123123",
                    "requiredDeliveryDate": "2024-07-22",
                    "quantity": 1,
                    "unitId": "EA",
                    "netUnitPrice": 6000.0,
                    "netTotalPrice": 6000.0
                }
            ]
        }
    ],
    "errors": []
}

⚠️ 201 (with errors)

Hay un error en la solicitud.

{
    "success": [],
    "errors": [
      {
        "traceId": "3095a0a77f80436ba104eb2fc24ba343"
        "cause": "PurchaseOrderNotFoundException",
        "message": "Purchase order 4500002 not found in backend SAP_APQ",
        "context": {
          "backendId": "SAP_APQ",
          "purchaseOrderId": "4500002"
        }
      }
    ]
}

🔒 401

Se requiere autorización o las credenciales no son correctas

{
    "traceId": "3095a0a77f80436ba104eb2fc24ba343"
    "cause": "UnauthorizedException",
    "message": "Authorization required"
}

🚧 500

Error interno de la aplicación (comuníquese con support@appliqloud.com o abra un ticket de soporte)

{
    "traceId": "3095a0a77f80436ba104eb2fc24ba343"
    "cause": "InternalServerError",
    "message": "Internal server error"
}