diff --git a/.gitignore b/.gitignore index e43b0f9..12e3668 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ .DS_Store +.vs/ diff --git a/posdealers/_markets/de/buy-resell/products/_notification.mdx b/posdealers/_markets/de/buy-resell/products/_notification.mdx index 9ff38df..8e8dc25 100644 --- a/posdealers/_markets/de/buy-resell/products/_notification.mdx +++ b/posdealers/_markets/de/buy-resell/products/_notification.mdx @@ -82,6 +82,67 @@ If the notification was successful, the operator receives a **confirmation email ![Confirmation Email](./images/ConfirmationEmail_DE.png) +## Trigger Notifications via API + +In addition to managing notifications through the portal, Dealers can trigger a notification for a specific Operator programmatically using the REST API. + +### Endpoint + +``` +POST api/notifications/de/triggermanually +``` + +### Authentication + +The request requires your Dealer account credentials passed as HTTP headers. + +| Header | Description | +|---------------|-----------------------------------------------------------------------------| +| `accountid` | Your Dealer account ID, found in the portal under `[COMPANYNAME]` / `Overview`. | +| `accesstoken` | Your Dealer account access token, found in the same location as the account ID. | + +### Request Body + +Send the PosOperator's account ID as a plain JSON string in the request body. + +**Example body** + +```json +"POSOPERATOR_ACCOUNT_ID" +``` + +### Example Requests + +**curl** + +```shell +curl.exe -X POST \ + -H "Content-Type: application/json" \ + -H "accountid: ACCOUNT_ID" \ + -H "accesstoken: ACCOUNT_ACCESS_TOKEN" \ + -d '"POSOPERATOR_ACCOUNT_ID"' \ + https://helipad.fiskaltrust.cloud/api/notifications/de/triggermanually +``` + +**Invoke-WebRequest (PowerShell)** + +```powershell +$headers = @{ accountid = "ACCOUNT_ID"; accesstoken = "ACCOUNT_ACCESS_TOKEN" } +$body = '"POSOPERATOR_ACCOUNT_ID"' +Invoke-WebRequest ` + -Uri https://helipad.fiskaltrust.cloud/api/notifications/de/triggermanually ` + -Method Post ` + -Headers $headers ` + -Body $body ` + -ContentType application/json +``` + +### Response + +A status code of `200` confirms that the notification trigger was accepted for the specified Operator. Check the Notifications page in the portal to monitor the resulting notification status. + +--- + ## Troubleshooting & Support ### Common Problems