Integration 5: Getting the Posted Invoice

1. Get all invoices in status: Posting
   Run GET {{API}}/api/v1.0/organizations/{{organizationId}}/clients/{{clientId}}/invoices in order to list all invoices ready for posting to the ERP system.
   Response
   "InvoiceStatus":"Posting"

   

2. Get one invoice
   Run GET {{API}}/api/v1.0/organizations/{{organizationId}}/clients/{{clientId}}/invoices/{{invoiceId}}
   Use the "invoiceId" value from the previous request to retrieve the processed invoice with all details.
   The response contains all invoice details as well as generated accounting lines.
   
   2.1 Cost Invoice Example
   Note that all necessary data should be contained in the array "invoiceAccountingLines"

   

   2.2 Purchase Order Invoice Example
   All required information should be contained in the array "purchaseInvoiceLines"
   

   

3. Set status: Posted
   Run PUT {{API}}/api/v1.0/organizations/{{organizationId}}/clients/{{clientId}}/invoices/{{invoiceId}}/status
   Request body:
   
   Response: 200 OK.
   
   
4. Check that status is Posted
   The invoice should now have invoiceStatus: Posted
   Verify this by repeating GET {{API}}/api/v1.0/organizations/{{organizationId}}/clients/{{clientId}}/invoices/{{invoiceId}}
   Expected response:
   
   
   
5. If posting error
   If the receiving ERP system cannot process the invoice for some reason, it is very useful to return an error message that contains instructions for correction along with the full error message.
   
   Run:
   PUT /api/v1/organizations/{organizationId}/clients/{clientId}/invoices/{invoiceId}/status
   

    { 
         "status": "PostingError", 
         "message": "Error message goes here."
    }

   
   This message will appear as a comment on the invoice in SEMINE which will enable the customer's administrator to correct any issues in ERP system before trying to post the invoice again.
   
   Example: