API Reference

Centara eMessaging exposes a set of API pages for integrating with Business Central data. These are standard BC API pages accessible via OData v4.

Base URL:

{BC Base URL}/api/centara/v1.0/companies({companyId})/

All endpoints are read-only (GET) unless otherwise noted. All endpoints support change tracking unless otherwise noted.


Approval Entries

Endpoint: .../approvalEntries

Source: Approval Entry table

FieldCaption
systemIdSystemId (key)
tableIDTable ID
documentTypeDocument Type
documentNoDocument No.
sequenceNoSequence No.
approvalCodeApproval Code
senderIDSender ID
salespersPurchCodeSalespers./Purch. Code
approverIDApprover ID
statusStatus
dateTimeSentForApprovalDate-Time Sent for Approval
lastDateTimeModifiedLast Date-Time Modified
lastModifiedByUserIDLast Modified By User ID
commentComment
dueDateApproval Due Date
amountAmount
amountLCYAmount (LCY)
currencyCodeCurrency Code
approvalTypeApproval Type
limitTypeLimit Type
availableCreditLimitLCYAvailable Credit Limit (LCY)
recordIDToApproveRecord ID to Approve
delegationDateFormulaDelegation Date Formula
entryNoEntry No.
workflowStepInstanceIDWorkflow Step Instance ID
relatedToChangeRelated to Change
rsmstaPurchaseDocumentTypePurchase Document Type
rsmstaDocumentLineNoDocument Line
rsmstaWorkflowUserGroupCodeWorkflow User Group Code

Certificate

Endpoint: .../certificates

Source: Temporary buffer. Supports POST (uploads a certificate).

FieldCaptionEditable
idId (key)No
extensionContentContent (binary)Yes
certificateSubjectCertificate SubjectNo (computed)
certificateValidToCertificate Valid ToNo (computed)

POST a binary certificate to extensionContent. The certificateSubject and certificateValidTo fields are computed and returned after upload.


Purchase Header Approval

Endpoint: .../purchHeaderApprovals

Source: Purchase Header — filtered to Status = Pending Approval. Document types: Invoice, Order, Credit Memo.

FieldCaption
systemIdSystemId (key)
documentTypeDocument Type
noNo.
amountAmount
amountIncludingVATAmount Including VAT
vendorOrderNoVendor Order No.
rsmstaEInvoiceVATTotaleInvoice VAT Total
rsmstaEInvoiceTotalAmteInvoice Total Amount
rsmstaEInvLineAmtInclVATeInvoice Total Amount Including VAT
rsmstaSecondApproverSecond Approver
rsmstaOriginalApprovalUserOriginal Approval User
rsmstaOriginalApprovalUserGroupApproval User Group
rsmsta4EyesWorkflowUserGroupFour Eyes Approval User Group
rsmstaEDocumentStatusCentara Outbound Document Status
rsmstaInboundDocumentStatusCentara Inbound Document Status
rsmstaIdentifierInWCIdentifier in Centara
rsmstaSentToCentaraOnSent to Centara On
rsmstaGuidGuid
rsmstaRejectionCodeRejection Code
rsmstaFromInboundEDocumentFrom Inbound e-Document
rsmstaIsOCRGeneratedIs OCR Generated

Actions

ActionMethodPurpose
ApproveFirstApproverPOSTApproves the entry for the original approval user
ApproveSecondApproverPOSTApproves the entry for the second approver

Purchase Line Approval

Endpoint: .../purchLineApprovals

Source: Purchase Line — filtered to Approval Status = Pending Approval. Document types: Invoice, Order, Credit Memo.

FieldCaption
systemIdSystemId (key)
documentTypeDocument Type
noNo.
amountAmount
amountIncludingVATAmount Including VAT
rsmstaOriginalApprovalUserOriginal Approval User
rsmstaOriginalApprovalUserGroupApproval User Group

Actions

ActionMethodPurpose
ApproveFirstApproverPOSTApproves the open approval entry for the original approval user on this line

Purchase Orders & Invoices

Endpoint: .../purchaseOrdersInvoices

Source: Purchase Header — document types: Order, Invoice.

FieldCaption
idSystemId (key)
rsmstaEInvoiceVATTotaleInvoice VAT Total
rsmstaEInvoiceTotalAmteInvoice Total Amount
rsmstaEInvLineAmtInclVATeInvoice Total Amount Including VAT
rsmstaSecondApproverSecond Approver
rsmstaOriginalApprovalUserOriginal Approval User
rsmstaOriginalApprovalUserGroupApproval User Group
rsmsta4EyesWorkflowUserGroupFour Eyes Approval User Group
rsmstaEDocumentStatusCentara Outbound Document Status
rsmstaInboundDocumentStatusCentara Inbound Document Status
rsmstaIdentifierInWCIdentifier in Centara
rsmstaSentToCentaraOnSent to Centara On
rsmstaGuidGuid
rsmstaRejectionCodeRejection Code
rsmstaFromInboundEDocumentFrom Inbound e-Document
rsmstaIsOCRGeneratedIs OCR Generated

Purchase Order & Invoice Lines

Endpoint: .../purchaseOrderInvoiceLines

Source: Purchase Line — document types: Order, Invoice.

FieldCaption
systemIdSystemId (key)
rsmstaLineGuidLine Guid
rsmstaOriginalApprovalUserOriginal Approval User
rsmstaApprovalStatusApproval Status
rsmstaRejectionCodeRejection Code
rsmstaUoMBeforeBaseUoMUnit Code before Base UoM
rsmstaOriginalApprovalUserGroupApproval User Group

Sales Orders

Endpoint: .../salesOrders

Source: Sales Header — document type: Order only. This page exposes the full Sales Header including all standard BC fields plus Centara-specific fields.

Key fields

FieldCaption
idSystemId (key)
noNo.
documentTypeDocument Type
statusStatus

Sell-to

FieldCaption
sellToCustomerNoSell-to Customer No.
sellToCustomerNameSell-to Customer Name
sellToAddressSell-to Address
sellToCitySell-to City
sellToPostCodeSell-to Post Code
sellToCountryRegionCodeSell-to Country/Region Code
sellToEMailEmail
sellToPhoneNoSell-to Phone No.

Bill-to

FieldCaption
billToCustomerNoBill-to Customer No.
billToNameBill-to Name
billToAddressBill-to Address
billToCityBill-to City
billToPostCodeBill-to Post Code
billToCountryRegionCodeBill-to Country/Region Code

Ship-to

FieldCaption
shipToCodeShip-to Code
shipToNameShip-to Name
shipToAddressShip-to Address
shipToCityShip-to City
shipToPostCodeShip-to Post Code
shipToCountryRegionCodeShip-to Country/Region Code
shipToPhoneNoShip-to Phone No.

Dates

FieldCaption
orderDateOrder Date
postingDatePosting Date
shipmentDateShipment Date
documentDateDocument Date
requestedDeliveryDateRequested Delivery Date
promisedDeliveryDatePromised Delivery Date
lastShipmentDateLast Shipment Date

Payment

FieldCaption
dueDateDue Date
paymentTermsCodePayment Terms Code
paymentDiscountPayment Discount
pmtDiscountDatePmt. Discount Date
paymentMethodCodePayment Method Code

Totals & currency

FieldCaption
amountAmount
amountIncludingVATAmount Including VAT
currencyCodeCurrency Code
currencyFactorCurrency Factor

References

FieldCaption
externalDocumentNoExternal Document No.
yourReferenceYour Reference

Logistics

FieldCaption
locationCodeLocation Code
shipmentMethodCodeShipment Method Code
shippingAgentCodeShipping Agent Code
shippingAgentServiceCodeShipping Agent Service Code
completelyShippedCompletely Shipped
shippedShipped
shippedNotInvoicedShipped Not Invoiced

VAT

FieldCaption
vatRegistrationNoVAT Registration No.
vatBusPostingGroupVAT Bus. Posting Group
vatReportingDateVAT Reporting Date

Dimensions

FieldCaption
shortcutDimension1CodeShortcut Dimension 1 Code
shortcutDimension2CodeShortcut Dimension 2 Code
dimensionSetIDDimension Set ID

Centara fields

FieldCaption
rsmstaEInvoiceVATTotaleInvoice VAT Total
rsmstaEInvoiceTotalAmteInvoice Total Amount
rsmstaEInvLineAmtInclVATeInvoice Total Amount Including VAT
rsmstaGuidGuid
rsmstaUpdatedGuidUpdated Guid
rsmstaLinesRecreatedOnLines Recreated On
rsmstaFromInboundEDocumentFrom Inbound e-Document

Job queue

FieldCaption
jobQueueStatusJob Queue Status
jobQueueEntryIDJob Queue Entry ID