BokaMera.API.Host

<back to all web services

CreateVossUsage

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/voss/usageAdd product to company invoicingAdd new product to company invoicing. Sends that product to VOSS System.
CreateVossUsage Parameters:
NameParameterData TypeRequiredDescription
CompanyIdbodyGuidYesThe company id
ArticleNumberbodystringYesArticle number. Can be fetched from products
QuantitybodyintYesExample: developer worked 6 hours
CreateSubscriptionProductGroupResult Parameters:
NameParameterData TypeRequiredDescription
ProductGroupTypeformProductGroupTypeEnumNo
StatusformStatusEnumNo
IdformGuidNo
NameformstringYes
ProductsformList<SubscriptionProductGroupProductResultDto>Yes
TerminationformSubscriptionItemTerminationDtoYes
CreatedformDateTimeNo
CustomerBalanceChangeformCustomerBalanceChangeDtoYes
ProductGroupTypeEnum Enum:
Optional
Included
StatusEnum Enum:
Active
Terminated
SubscriptionProductGroupProductResultDto Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
NameformstringYes
ExternalIdformstringYes
ArticleNumberformstringYes
SubscriptionItemTerminationDto Parameters:
NameParameterData TypeRequiredDescription
TypeformTypeEnumNo
SourceformSourceEnumNo
ScheduledDateformDateTimeNo
ReasonformSubscriptionItemTerminationReasonDtoYes
CreditOptionsformCreditOptionsDtoYes
TypeEnum Enum:
AtSubscriptionBillingPeriodEnd
AtBindingPeriodEnd
Immediately
SourceEnum Enum:
Direct
Plan
CustomerExpiration
Update
Unpaid
SubscriptionItemTerminationReasonDto Parameters:
NameParameterData TypeRequiredDescription
ReasonIdformGuidNo
ReasonNameformstringYes
ReasonExternalIdformstringYes
SubReasonIdformGuid?No
SubReasonNameformstringYes
SubReasonExternalIdformstringYes
CommentformstringYes
CreditOptionsDto Parameters:
NameParameterData TypeRequiredDescription
SubscriptionBehaviourformSubscriptionBehaviourEnumNo
CreditKindformCreditKindEnumNo
ProrateTimeAnchorformDateTime?No
SubscriptionBehaviourEnum Enum:
Prorate
Full
None
CreditKindEnum Enum:
Normal
Internal
CustomerBalanceChangeDto Parameters:
NameParameterData TypeRequiredDescription
ItemsformList<CustomerBalanceChangeItemDto>Yes
TotalAmountformdoubleNo
TotalDiscountAmountformdoubleNo
CustomerBalanceChangeItemDto Parameters:
NameParameterData TypeRequiredDescription
ProductTypeformProductTypeEnumNo
IdformGuidNo
NameformstringYes
ProductGroupIdformGuidNo
ProductGroupNameformstringYes
QuantityformdoubleNo
AmountformdoubleNo
DiscountAmountformdoubleNo
TotalAmountformdoubleNo
InvoiceRecipientCustomerIdformGuidNo
ProductTypeEnum Enum:
Main
Addon
License
Usage

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /voss/usage HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"ArticleNumber":"String","Quantity":0}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"productGroupType":"Optional","status":"Active","name":"String","products":[{}]}