Skip to main content

Marketplace & Distribution Endpoints (cont.)

DattoCommerceDetails (continued)

GET /DattoCommerceDetails/{id}

Get a single Datto Commerce integration. Returns a single instance of DattoCommerceDetails. Requires authentication.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID
includedetailsbooleanNo (query)Include additional detail objects

DELETE /DattoCommerceDetails/{id}

Delete a Datto Commerce integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

AdobeCommerceDetails

Manage Adobe Commerce (Magento) integration credentials and configuration.

GET /AdobeCommerceDetails

List all Adobe Commerce integration configurations.

POST /AdobeCommerceDetails

Create or update Adobe Commerce integration configurations.

Request body: Array of AdobeCommerceDetails

AdobeCommerceDetails schema (key fields):

PropertyTypeDescription
idintegerRecord ID
connectionnamestringConnection name
urlstringAdobe Commerce store URL
new_integration_methodbooleanUse new auth method
enabledbooleanIntegration enabled
integrator_last_syncstring (date-time)Last sync timestamp
_warningstringWarning message

GET /AdobeCommerceDetails/{id}

Get a single Adobe Commerce integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /AdobeCommerceDetails/{id}

Delete an Adobe Commerce integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

AdobeCommerceIntegration

OAuth authorization flow for Adobe Commerce.

GET /AdobeCommerceIntegration

Get Adobe Commerce integration status.

POST /AdobeCommerceIntegration/auth

Authenticate with Adobe Commerce via OAuth. Accepts form data key-value pairs for the OAuth handshake.

Request body: multipart/form-data with obj field (array of StringStringValuesKeyValuePair)


CSPConsumptionData

Manage Microsoft CSP consumption/usage data records. Used for reconciliation billing.

GET /CSPConsumptionData

List all CSP consumption data records.

POST /CSPConsumptionData

Create or import CSP consumption data records.

Request body: Array of CSPConsumptionData

CSPConsumptionData schema (key fields):

PropertyTypeDescription
idintegerRecord ID
parentidintegerParent record ID
typeintegerRecord type
partnerid / partnernamestringPartner ID and name
customerid / customernamestringCustomer ID and name
customerdomainnamestringCustomer domain
invoicenumberstringInvoice number
skuid / skunamestringSKU identifier and name
productnamestringProduct name
subscriptionidstringSubscription ID
subscriptiondescriptionstringSubscription description
chargestartdate / chargeenddatestring (date-time)Charge period
usagedatestring (date-time)Usage date
quantitynumberUsage quantity
unitpricenumberUnit price
subtotal / taxtotal / totalnumberBilling amounts
billingcurrency / pricingcurrencystringCurrency codes
meterid / metername / metercategorystringAzure meter details
entitlementid / entitlementdescriptionstringEntitlement info
creditpercentage / credittypestringCredit information
termandbillingcyclestringTerm and billing cycle
subscriptionstartdate / subscriptionenddatestring (date-time)Subscription period
isbilledbooleanWhether record has been billed
_isimportbooleanImport mode flag
_warningstringWarning message

GET /CSPConsumptionData/{id}

Get a single CSP consumption data record by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /CSPConsumptionData/{id}

Delete a CSP consumption data record.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

POST /CSPConsumptionData/manage

Bulk manage (create/update) CSP consumption data records.

Request body: Array of CSPConsumptionData

DELETE /CSPConsumptionData/Parent/{id}

Delete all CSP consumption data records belonging to a parent record.

ParameterTypeRequiredDescription
idintegerYes (path)Parent record ID

CSPInvoice

Manage Microsoft CSP invoice records.

GET /cspinvoice

List all CSP invoice records.

POST /cspinvoice

Create or import CSP invoice records.

Request body: Array of CSPInvoice

CSPInvoice schema:

PropertyTypeDescription
haloidintegerHaloPSA record ID
idstringCSP invoice ID
tenantidintegerTenant ID
invoicedatestring (date-time)Invoice date
totalchargesnumberTotal charges
paidamountnumberAmount paid
currencycode / currencysymbolstringCurrency
pdfdownloadlinkstringPDF download URL
taxreceiptsarrayTax receipts (CSPTaxReceipt objects)
invoicedetailsarrayInvoice line items (CSPInvoiceDetail objects)
documenttypestringDocument type
invoicetypestringInvoice type
linksobjectCSP links (CSPLinks)
isbilledbooleanWhether invoice has been billed
isfullybilledbooleanWhether invoice is fully billed
haslinesbooleanWhether invoice has line items
client_idintegerAssociated client ID
mark_as_billedbooleanMark invoice as billed
update_billed_statebooleanUpdate billed state
_isimportbooleanImport mode flag
_warningstringWarning message

GET /cspinvoice/{id}

Get a single CSP invoice by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /cspinvoice/{id}

Delete a CSP invoice record.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

CSPSubscriptionPricing

Manage Microsoft CSP subscription pricing data.

POST /CSPSubscriptionPricing/manage

Bulk create or update CSP subscription pricing records.

Request body: Array of CSPSubscriptionPricing

CSPSubscriptionPricing schema:

PropertyTypeDescription
idintegerRecord ID
marketplacestringMarketplace identifier
producttitle / productidstringProduct name and ID
skuid / skutitlestringSKU identifier and title
skudescriptionstringSKU description
publisherstringPublisher name
unitofmeasurestringUnit of measure
termdurationstringTerm duration
billingplanstringBilling plan
marketstringMarket
currencystringCurrency code
unitpricenumberUnit price
pricingtierrangemin / pricingtierrangemaxnumberPricing tier range
effectivestartdate / effectiveenddatestring (date-time)Effective date range
erp_pricenumberERP price
segmentstringSegment
tagsstringTags
_warningstringWarning message

MicrosoftSubscriptionMapping

Manage Microsoft SharePoint and subscription mappings for the HaloIntegrator.

GET /MicrosoftSubscriptionMapping

List all Microsoft subscription mappings.

POST /MicrosoftSubscriptionMapping

Create or update Microsoft subscription mappings.

Request body: Array of MicrosoftSubscriptionMapping

MicrosoftSubscriptionMapping schema (key fields):

PropertyTypeDescription
idintegerRecord ID
halo_id / halo_nameinteger/stringHaloPSA entity reference
microsoft_id / microsoft_namestringMicrosoft entity reference
site_path / site_namestringSharePoint site path and name
azure_connection_idintegerAzure AD connection ID
subscription_idstringMicrosoft subscription ID
subscription_expirystring (date-time)Subscription expiry date
subscribedbooleanWhether subscribed
new_subscription_keystringNew subscription key (write-only)
change_tokenstringSharePoint change token
typeintegerMapping type
sharing_typeintegerSharing type
fullnamestringFull display name
mappings_folderarrayField mappings (IntegrationFieldMapping)
_subscriptionactionobjectWebhook subscription action
azure_connectionobjectAzure AD connection details
sharepoint_list / sharepoint_graph_listobjectSharePoint list references
sharepoint_site / sharepoint_graph_siteobjectSharePoint site references

GET /MicrosoftSubscriptionMapping/{id}

Get a single Microsoft subscription mapping by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /MicrosoftSubscriptionMapping/{id}

Delete a Microsoft subscription mapping.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

AmazonSellerDetails

Manage Amazon Seller integration for e-commerce order ingestion.

GET /AmazonSellerDetails

List all Amazon Seller integration configurations.

POST /AmazonSellerDetails

Create or update Amazon Seller integration configurations.

Request body: Array of AmazonSellerDetails

AmazonSellerDetails schema:

PropertyTypeDescription
idintegerRecord ID
storefrontnamestringStorefront/shop name
new_integration_methodbooleanUse new auth method
redirect_uristringOAuth redirect URI
new_access_tokenstringAccess token (write-only)
new_refresh_tokenstringRefresh token (write-only)
_codestringOAuth authorization code
_exchangecodebooleanTrigger OAuth code exchange
authorizedbooleanWhether integration is authorized
enabledbooleanIntegration enabled
endpointstringAmazon API endpoint
marketplacestringAmazon marketplace identifier
_warningstringWarning message

GET /AmazonSellerDetails/{id}

Get a single Amazon Seller integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /AmazonSellerDetails/{id}

Delete an Amazon Seller integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

ShopifyDetails

Manage Shopify store integration for e-commerce order ingestion.

GET /ShopifyDetails

List all Shopify integration configurations.

POST /ShopifyDetails

Create or update Shopify integration configurations.

Request body: Array of ShopifyDetails

ShopifyDetails schema:

PropertyTypeDescription
idintegerRecord ID
shopnamestringShopify store name
new_integration_methodbooleanUse new auth method
new_access_tokenstringAccess token (write-only)
codestringOAuth authorization code
_exchangecodebooleanTrigger OAuth code exchange
_disconnectbooleanDisconnect the integration
authorizedbooleanWhether integration is authorized
enabledbooleanIntegration enabled
_warningstringWarning message

GET /ShopifyDetails/{id}

Get a single Shopify integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /ShopifyDetails/{id}

Delete a Shopify integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

EcommerceOrder

Manage e-commerce orders imported from Amazon, Shopify, or Adobe Commerce. These orders can be linked to HaloPSA tickets.

GET /EcommerceOrder

List all e-commerce order records.

POST /EcommerceOrder

Create or update e-commerce order records.

Request body: Array of EcommerceOrder

EcommerceOrder schema:

PropertyTypeDescription
idintegerRecord ID
moduleidintegerIntegration module ID
thirdpartyidstringOrder ID in third-party system
thirdpartyurlstringURL to order in third-party system
thirdpartyordernumberstringHuman-readable order number
thirdpartycustomeridstringCustomer ID in third-party system
thirdpartystatusstringPrimary order status
thirdpartystatus2stringSecondary order status
thirdpartycreateddatestring (date-time)Order creation date
integration_namestringName of the integration source
ticket_idintegerLinked HaloPSA ticket ID
details_idintegerIntegration details record ID
shop_namestringShop/storefront name
_unlink_from_ticketbooleanUnlink order from ticket
jsonobjstringRaw JSON from third-party
_amazon_buyer_infoobjectAmazon buyer info (AmazonSellerBuyerInfo)
_adobecommerce_billing_addressobjectAdobe Commerce billing address
linked_ticketsarrayLinked ticket records (EcommerceOrderFault)

GET /EcommerceOrder/{id}

Get a single e-commerce order by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /EcommerceOrder/{id}

Delete an e-commerce order record.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID