BokaMera.API.Host

<back to all web services

CreateSummarizedInvoice

Requires Authentication
The following routes are available for this service:
POST/eaccounting/summarizedinvoiceCreate summarized invoices for customer bookings in a date rangeCreates a single invoice per customer covering all their bookings in the specified date range. Processing is async via queue.
CreateSummarizedInvoice Parameters:
NameParameterData TypeRequiredDescription
CompanyIdbodyGuid?NoThe company id, if empty will use the company id for the user you are logged in with.
DateFrombodyDateTimeYesStart date for the booking range to include.
DateTobodyDateTimeYesEnd date for the booking range to include.
CustomerIdbodyGuid?NoOptional customer id. If null, creates one summarized invoice per customer with eligible bookings.
ServiceIdbodyint?NoOptional service/event id filter. Only include bookings for this service.
BookingStatusIdsbodyList<int>NoOptional list of booking status ids to include. If empty, all statuses are included.
TermsOfPaymentIdbodystringYesThe terms of payment id from EAccounting.
CreateTypebodystringNoInvoice creation type: 'Draft' or 'Invoice'. Defaults to company's EAccounting DefaultCreateType.
SendTypebodyEAccountingInvoiceSendTypes?NoSend type for final invoices. 0 = None, 1 = AutoInvoiceElectronic, 2 = AutoInvoicePrint, 3 = AutoInvoiceB2C.
CorporateIdentityNumberbodystringNoOverride corporate identity number for invoice address.
InvoiceAddress1bodystringNoOverride invoice address line 1.
InvoiceAddress2bodystringNoOverride invoice address line 2.
InvoiceCitybodystringNoOverride invoice city.
InvoicePostalCodebodystringNoOverride invoice postal code.
InvoiceCountryCodebodystringNoOverride invoice country code.
EAccountingInvoiceSendTypes Enum:
None
AutoInvoiceElectronic
AutoInvoicePrint
AutoInvoiceB2C
CreateSummarizedInvoiceResponse Parameters:
NameParameterData TypeRequiredDescription
TotalCustomersQueuedformintNo
JobsformList<SummarizedInvoiceJobResponse>Yes
ResponseStatusformResponseStatusYes
SummarizedInvoiceJobResponse Parameters:
NameParameterData TypeRequiredDescription
SummarizedInvoiceIdformGuidNo
CustomerIdformGuidNo
CustomerNameformstringYes
BookingCountformintNo

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

HTTP + XML

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

POST /eaccounting/summarizedinvoice HTTP/1.1 
Host: api.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateSummarizedInvoice xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <BookingStatusIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:int>0</d2p1:int>
  </BookingStatusIds>
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <CorporateIdentityNumber>String</CorporateIdentityNumber>
  <CreateType>String</CreateType>
  <CustomerId>00000000-0000-0000-0000-000000000000</CustomerId>
  <DateFrom>0001-01-01T00:00:00</DateFrom>
  <DateTo>0001-01-01T00:00:00</DateTo>
  <InvoiceAddress1>String</InvoiceAddress1>
  <InvoiceAddress2>String</InvoiceAddress2>
  <InvoiceCity>String</InvoiceCity>
  <InvoiceCountryCode>String</InvoiceCountryCode>
  <InvoicePostalCode>String</InvoicePostalCode>
  <SendType>None</SendType>
  <ServiceId>0</ServiceId>
  <TermsOfPaymentId>String</TermsOfPaymentId>
</CreateSummarizedInvoice>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<CreateSummarizedInvoiceResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Jobs>
    <SummarizedInvoiceJobResponse>
      <BookingCount>0</BookingCount>
      <CustomerId>00000000-0000-0000-0000-000000000000</CustomerId>
      <CustomerName>String</CustomerName>
      <SummarizedInvoiceId>00000000-0000-0000-0000-000000000000</SummarizedInvoiceId>
    </SummarizedInvoiceJobResponse>
  </Jobs>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <TotalCustomersQueued>0</TotalCustomersQueued>
</CreateSummarizedInvoiceResponse>