This endpoint creates a purchase order in ACP3.
https://devapiacp3.axosnet.io/api/v1/PurchaseOrder/Create | Method POST |
Body:
{
"clientTaxId": "string",
"clientName": "string",
"supplierTaxId": "string",
"supplierName": "string",
"amountWithoutVat": 0,
"currencyCode": "string",
"description": "string",
"discountPercentage": 0,
"discountTerms": "string",
"id": 0,
"isTest": true,
"isChangeOrder": true,
"ledgerCode": "string",
"name": "string",
"neededByDate": "2023-09-14T21:01:18.142Z",
"orderDate": "2023-09-14T21:01:18.142Z",
"paymentTerms": "string",
"policyExternalID": 0,
"poVendorTaxId": 0,
"provincialTaxId": 0,
"purchaseOrderNumber": "string",
"purchaseRequestNumber": "string",
"receiptType": "string",
"requestedBy": "string",
"requestedDeliveryDate": "2023-09-14T21:01:18.142Z",
"shipping": 0,
"shippingDescription": "string",
"shippingMethodKey": "string",
"shippingTermsKey": "string",
"status": true,
"taxPurchaseOrder": 0,
"uri": "string",
"vatAmountOne": 0,
"vatAmountTwo": 0,
"vatRateOne": 0,
"vatRateTwo": 0,
"vendorAccountNumber": "string",
"vendorAddressCode": "string",
"vendorCode": "string",
"totalGrossValue": 0,
"lastChangeDate": "2023-09-14T21:01:18.142Z",
"lastChangeTime": "2023-09-14T21:01:18.142Z",
"isDeleted": true,
"listItem": [
{
"accountCode": "string",
"amountWithoutVat": 0,
"createDate": "2023-09-14T21:01:18.142Z",
"description": "string",
"expenseType": "string",
"externalID": "string",
"isReceiptRequired": true,
"lineNumber": "string",
"quantity": 0,
"purchaseOrderReceiptType": "string",
"requestedBy": "string",
"requestedDeliveryDate": "2023-09-14T21:01:18.142Z",
"supplierPartID": "string",
"tax": 0,
"unitOfMeasureCode": "string",
"unitPrice": 0,
"vatAmount": 0,
"vatRate": 0,
"itemDeletionIndicator": true,
"grossValueItem": 0,
"isDeleted": true,
"allocation": [
{
"amount": 0,
"grossAmount": 0,
"percentage": 0,
"isDeleted": true
}
]
}
],
"billToAddress": {
"address1": "string",
"address2": "string",
"address3": "string",
"city": "string",
"countryCode": "string",
"externalID": "string",
"name": "string",
"postalCode": "string",
"stateProvince": "string"
},
"shipToAddress": {
"address1": "string",
"address2": "string",
"address3": "string",
"city": "string",
"countryCode": "string",
"externalID": "string",
"name": "string",
"postalCode": "string",
"stateProvince": "string"
},
"sapeccSpecifics": {
"logicalSystem": "string",
"clientNumber": "string",
"documentType": "string",
"companyCode": "string",
"purchasingOrgDesc": "string",
"purchasingGrpDesc": "string"
}
}
Body |
Results:
StatusCode | Message |
200 | Ok |
400 | Data Error |
400 | The Application is not subscribed |
401 | unauthorized |
500 | Exception Message |
Notes:
- In order to update a purchase order, the following mandatory fields are required:
PurchaseOrder:
- purchaseOrderNumber
Items:
- LineNumber
If you need to delete a purchase order, the following fields are required:
- “purchaseOrderNumber”: “PO98765”,
- “isDeleted”: true
If you need to delete a item of the purchase order, the following fields are required:
“listItem”: [
{
“lineNumber”: “001”,
“isDeleted”: true
}
- The data that is not going to be provided and that is not mandatory, set the value NULL
- “paymentTerms”: null,
- “policyExternalID”: null,
- “poVendorTaxId”: null,
- “provincialTaxId”: null,
Step to Step:
JSON |
Notes |
Get token with ClientId and Client Secret |
Copy and paste token |
Set body |
{
"clientTaxId": null,
"clientName": null,
"supplierTaxId": null,
"supplierName": null,
"amountWithoutVat": null,
"currencyCode": null,
"description": null,
"discountPercentage": null,
"discountTerms": null,
"id": null,
"isTest": null,
"isChangeOrder": null,
"ledgerCode": null,
"name": null,
"neededByDate": null,
"orderDate": null,
"paymentTerms": null,
"policyExternalID": null,
"poVendorTaxId": null,
"provincialTaxId": null,
"purchaseOrderNumber": "PO12023",
"purchaseRequestNumber": null,
"receiptType": null,
"requestedBy": null,
"requestedDeliveryDate": null,
"shipping": null,
"shippingDescription": null,
"shippingMethodKey": null,
"shippingTermsKey": null,
"status": null,
"taxPurchaseOrder": null,
"uri": null,
"vatAmountOne": null,
"vatAmountTwo": null,
"vatRateOne": null,
"vatRateTwo": null,
"vendorAccountNumber": null,
"vendorAddressCode": null,
"vendorCode": null,
"totalGrossValue": null,
"lastChangeDate": null,
"lastChangeTime": null,
"isDeleted": false,
"listItem": [
{
"accountCode": null,
"amountWithoutVat": null,
"createDate": null,
"description": null,
"expenseType": null,
"externalID": null,
"isReceiptRequired": null,
"lineNumber": "01",
"quantity": null,
"purchaseOrderReceiptType": null,
"requestedBy": null,
"requestedDeliveryDate": null,
"supplierPartID": null,
"tax": null,
"unitOfMeasureCode": null,
"unitPrice": null,
"vatAmount": null,
"vatRate": null,
"itemDeletionIndicator": null,
"grossValueItem": null,
"isDeleted": true,
"allocation": [
{
"amount": null,
"grossAmount": null,
"percentage": null,
"isDeleted": null
}
]
}
],
"billToAddress": {
"address1": null,
"address2": null,
"address3": null,
"city": null,
"countryCode": null,
"externalID": null,
"name": null,
"postalCode": null,
"stateProvince": null
},
"shipToAddress": {
"address1": null,
"address2": null,
"address3": null,
"city": null,
"countryCode": null,
"externalID": null,
"name": null,
"postalCode": null,
"stateProvince": null
},
"sapeccSpecifics": {
"logicalSystem": null,
"clientNumber": null,
"documentType": null,
"companyCode": null,
"purchasingOrgDesc": null,
"purchasingGrpDesc": null
}
}
Example (Body) |
Result |
Result:
StatusCode | Message |
200 | Ok |
400 | Data Error |
400 | The Application is not subscribed |
401 | unauthorized |
500 | Exception Message |