Purchase - ProcessPurchaseInvoices(sessionID, administrationId, xmlDoc)

Modified on Thu, 08 Jun 2023 at 10:11 AM

Yuki Web service - Purchase invoices 

This web service enables you to import purchase invoices from an ERP-system into an dministration in Yuki based on the provided XML message. This web service is specially developed for this purpose and offers an alternative for the manual input of purchase  invoices within the Yuki wenb application. 


Procedure 


Compile the XML with the purchase invoices

Gather the invoice data in a XML document and offer this file to our web service. The web service validates the XML document with the XML scheme (XSD). If the XML document doesn't pass through the validation the process will be cancelled and the web service will respond with a detailed validation notification.


Call the web service method with the relevant XML message 


Validation

After the validation process has been completed successfully the invoices will be retrieved from the XML document and will be processed one by one. During the processing of an invoice new contact persons (suppliers) will be created automatically. Existing contact persons will be matched based on the name or the contact ID.


Processing

During the processing of an incomplete or an incorrectly drawn up invoice, the invoice will be cancelled whereby all processing already carried out will be undone. The possible creation of new contact persons will be reversed immediately. An invoice can be incomplete when for example new contact persons are offered without name or contact ID.


Status response

At the end of the processing the web service generates a response XML document that contains the processing status of the invoices and the possible validation messages. This XML document is specified in a XML scheme (XSD) and can be processed by your application. You wil find an example in article Purchase ProcessPurchaseInvoices Response XML.


The status and the processing of invoices are determined based on a number of parameters that have to be specified per invoice.


For a functional description of the fields in the purcahse invoices XML see article Purchase- Functional description of fields purchase invoices XML.  


ProcessPurchaseInvoices(sessionID, administrationId, xmlDoc)

Creates purhcase invoices based on the provided XML. 


Parameters


sessionID

The session ID that is returned by the Authenticate(accessKey) method.


administrationID

The identifier of the administration. For a description where to find the administrationID see article Administration ID.


xmlDoc

The XML fragment with the purchase invoices.


Web address of XML scheme of purchase invoices


http://www.yukiworks.nl/schemas/PurchaseInvoices.xsd


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article