Endpoint Purchase Order

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