{ "opencollection": "1.0.0", "info": { "name": "Fixxbook.Bearer.Api.V1 AfterHours Invoices API", "version": "bearer.v1" }, "items": [ { "info": { "name": "Invoices", "type": "folder" }, "items": [ { "info": { "name": "Retrieve general invoice settings for a subscriber", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:subscriberId/InvoiceRequirements", "params": [ { "name": "subscriberId", "value": "", "type": "path", "description": "Unique numeric identifier of the subscriber to return general invoice settings for." } ] }, "docs": "Returns general invoice settings for the specified subscriber.\r\n
Both subscribers and providers can use this method.\r\n  • **Subscribers** should enter their subscriber ID.\r\n  • **Providers** need to pass the ID of the subscriber they have a contract with.\r\n
Subscriber users with the *Super Admin* secondary role set up general invoice parameters in **Admin** > **Invoices** > **General**, where they configure when invoices can be create" }, { "info": { "name": "Retrieve invoice other descriptions for selected category and subscriber", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:subscriberId/OtherChargeOptions/:category", "params": [ { "name": "subscriberId", "value": "", "type": "path", "description": "Unique numeric identifier of the subscriber" }, { "name": "category", "value": "", "type": "path", "description": "Category name" } ] }, "docs": "Returns invoice other descriptions for the specified subscriber and category.\r\n
Both subscribers and providers can use this method.\r\n  • **Subscribers** should enter their subscriber ID.\r\n  • **Providers** need to pass the ID of the subscriber they have a contract with." }, { "info": { "name": "Retrieve invoice rejection reasons for a subscriber", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:subscriberId/InvoiceRejectionReasons", "params": [ { "name": "subscriberId", "value": "", "type": "path", "description": "Unique numeric identifier of the subscriber to return invoice rejection reasons for." } ] }, "docs": "Returns invoice rejection reasons for a subscriber\r\n
Both subscribers and providers can use this method.\r\n  • **Subscribers** should enter their subscriber ID.\r\n  • **Providers** need to pass the ID of the subscriber they have a contract with." }, { "info": { "name": "Allows reject non-MLI(Multilevel Invoice Approval) invoice", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/invoices/:invoiceId/reject", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice Identifier" }, { "name": "comments", "value": "", "type": "query", "description": "Comments" }, { "name": "isNotifyProvider", "value": "", "type": "query", "description": "Request to notify provider" }, { "name": "additionalEmails", "value": "", "type": "query", "description": "Additional Emails" } ] }, "docs": "Allows reject non-MLI(Multilevel Invoice Approval) invoice" }, { "info": { "name": "Allows put invoice on hold for non-MLI(Multilevel Invoice Approval) invoice", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/invoices/:invoiceId/onhold", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice Identifier" }, { "name": "comments", "value": "", "type": "query", "description": "Comments" } ] }, "docs": "Allows put invoice on hold for non-MLI(Multilevel Invoice Approval) invoice" }, { "info": { "name": "Allows approve non-MLI(Multilevel Invoice Approval) invoice", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/invoices/:invoiceId/approve", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice Identifier" }, { "name": "approvalCode", "value": "", "type": "query", "description": "Approval Code" }, { "name": "comments", "value": "", "type": "query", "description": "Comments" }, { "name": "category", "value": "", "type": "query", "description": "Category" } ] }, "docs": "Allows approve non-MLI(Multilevel Invoice Approval) invoice" }, { "info": { "name": "Retrieve statistics of all invoices", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/statistics", "params": [ { "name": "daysPeriod", "value": "", "type": "query", "description": "Period in days, last X days for which Invoices statistics was collected (30 by Default)." }, { "name": "approvedInThePastDaysPeriod", "value": "", "type": "query", "description": "Period in days, last X days during which Invoices are approved (3 by Default)." } ] }, "docs": "Retrieves statistics of all invoices. Returns the statistics of all invoices for successful request.\r\n

Only for providers usage." }, { "info": { "name": "Add an invoice to a work order", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/invoices" }, "docs": "Creates an invoice in the *Open* status for the specified work order.\r\n
Find out more about [creating an invoice](https://servicechannel.atlassian.net/wiki/spaces/SCU/pages/2205811424/Creating+an+Invoice) in ServiceChannel University." }, { "info": { "name": "Get an invoice", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:invoiceId", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Numeric identifier of the invoice to get the details for." } ] }, "docs": "Returns the details of the specified invoice." }, { "info": { "name": "Get rates discrepancy", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:invoiceId/discrepancy", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice identifier." } ] }, "docs": "Retrieves Invoice rates discrepancy information. Returns the labor list with rates discrepancy for the specified invoice." }, { "info": { "name": "Get rates discrepancy", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/:invoiceId/discrepancyExtended", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice identifier." } ] }, "docs": "Retrieves Invoice rates discrepancy information. Returns the labor list with rates discrepancy for the specified invoice." }, { "info": { "name": "Add a payment to an invoice", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/invoices/:invoiceId/Payment", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Unique numeric identifier of the invoice to add a payment to." } ] }, "docs": "Creates a payment record for the specified invoice in the *Approved* status.\r\n
Send this request [GET/odata/invoices](/swagger/ui/index?version=3#/Invoices/Invoices_GetInvoices) to get the invoice ID.\r\n
Learn [how subscribers can mark invoices as paid](https://servicechannel.atlassian.net/wiki/spaces/SCU/pages/621936646/Marking+Invoices+as+Paid) in ServiceChannel University.\r\n
**Example Request**\r\n \r\n POST /invoices/{in" }, { "info": { "name": "Add payment records to invoices", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/invoices/Payments" }, "docs": "Creates payment records for the invoices in the *Approved* status in bulk.\r\n
**Note**: This method is available to users with the *Invoice Admin* role and with the *InvoiceChangeToPaid* feature flag enabled.\r\n
**Example Request**\r\n \r\n POST /invoices/Payments\r\n {\r\n \"Payments\": [\r\n {\r\n \"InvoiceId\": 96814318,\r\n \"PaymentDate\": \"2021-12-13T0" }, { "info": { "name": "Add a payment record to an invoice by a tracking number", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/invoices/Workorders/:trackingNumber/Payment", "params": [ { "name": "trackingNumber", "value": "", "type": "path", "description": "Tracking number of the work order you want to add the invoice payment record for." } ] }, "docs": "Creates a payment record for the invoice in the *Approved* status by specifying the tracking number of the work order the invoice was created for.\r\n
Learn [how subscribers can mark invoices as paid](https://servicechannel.atlassian.net/wiki/spaces/SCU/pages/621936646/Marking+Invoices+as+Paid) in ServiceChannel University." }, { "info": { "name": "Get Projects Invoices", "type": "http" }, "http": { "method": "POST", "url": "{{baseUrl}}/invoices/GetProjectsInvoicesIgnoreAccessRights" }, "docs": "Retrieve All Invoices for Projects Cost Info Ignoring User Access Rights" }, { "info": { "name": "Checks state of a service for invoice.", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/invoices/ping/:serviceName", "params": [ { "name": "serviceName", "value": "", "type": "path", "description": "Service Name identifier: The value of parameter is 'TWUtilityManager' or 'TWCalculationManager' in currently." } ] }, "docs": "The method allow check some service for invoice for availability state.
Responses: 'Success' or 'Fail'." }, { "info": { "name": "Update GlCode", "type": "http" }, "http": { "method": "PATCH", "url": "{{baseUrl}}/invoices/:invoiceId/GlCode", "params": [ { "name": "invoiceId", "value": "", "type": "path", "description": "Invoice Id" } ] }, "docs": "Update GlCode" }, { "info": { "name": "Retrieve Invoices", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/odata/invoices", "params": [ { "name": "$expand", "value": "", "type": "query", "description": "Expand a navigation property." }, { "name": "$select", "value": "", "type": "query", "description": "Select a set of properties to return." }, { "name": "$filter", "value": "", "type": "query", "description": "Filter a collection of resources addressed by a request URL." }, { "name": "$orderby", "value": "", "type": "query", "description": "Order resources by the specified property in the response." }, { "name": "$top", "value": "", "type": "query", "description": "Return the specified number of items in the response." }, { "name": "$skip", "value": "", "type": "query", "description": "Skip the specified number of items in the response." }, { "name": "$count", "value": "", "type": "query", "description": "Include the count of the matching resources in the response." } ] }, "docs": "Returns a list of invoices posted within the last 90 days if not specified otherwise in `$filter`. The maximum date range between the invoice `PostedDate` and the current date is 365 days." } ] } ], "bundled": true }