# eShop Example # Overview ## Using Atollon to bill/invoice eShop purchases How to use Atollon to quickly send invoices to eShop clients? See the illustration below describing the scheme necessary to adopt when billing from Atollon. [![eShopIntegration.png](https://help.atollon.com/uploads/images/gallery/2020-05/scaled-1680-/eShopIntegration.png)](https://help.atollon.com/uploads/images/gallery/2020-05/eShopIntegration.png) ### Used Functions Functions to create objects: (there may be some other functions necessary, if listing is required) - CreateContact (main.wsdl) - Use for both company & person - CreateSimpleFolder (project.wsdl) - For both company & person clients - CreateProject (project.wsdl) - CreateProjectItem (item.wsdl) # Create New Customer (Person) ### First create new contact #### CreateContact (main.wsdl) Request ```XML acme 6A941A9BC9EBEFAF585A4B936AA958755B1C85E2BD04 Jack Buyer
London United Kingdom 1 London Our Street 10 132027101 1100
jackbuyer@gmail.com 1 1 132031101 33999888 0 1 132035101 990888333 0 1 132033101 3 Dear Adam 131428101 ``` #### CreateContact Response ```XML OK 139663101 ``` ### Create New Customer Folder #### CreateSimpleFolder (project.wsdl) Request ```XML acme 6A941A9BC9EBEFAF585A4B936AA958755B1C85E2BD04 Buyer, Jack 130944101 139663101 130944101 ``` #### CreateSimpleFolder Response ```XML OK 139676101 Client 132716101 1 0 ``` # Create New Deal ### First Create Project Folder #### CreateProject (project.wsdl) Request ```XML acme 6A941A9BC9EBEFAF585A4B936AA958755B1C85E2BD04 139676101 139676101 133150101 Super Sales 133297101 132740101 ``` #### CreateProject Response ```XML OK 139704101 133295101 Deal 0 2 ``` ### Second Create Billing Item #### CreateProjectItem (item.wsdl) Request ```XML acme 6A941A9BC9EBEFAF585A4B936AA958755B1C85E2BD04 1234 2020-05-14T00:00:00 3 5 190 CZK 133629101 AAA Batteries 139704101 130 5 6170 6787 10 100 ``` #### CreateProjectItem Response ```XML OK 0 139721101 ``` # Create New Invoice ### Create Invoice from Billing Items in For approval Status #### CreateInvoicesFromItems (invoice.wsdl) Request ```XML acme 6A941A9BC9EBEFAF585A4B936AA958755B1C85E2BD04 139704101 ``` #### CreateInvoicesFromItems Response ```XML OK 139758101 232010001 ``` # Create Recurring Billing Request On top of created project (deal), it is possible to create recurring billing request. See the documentation of [CreateFolderItem](https://help.atollon.com/books/atollon-api/page/createfolderitem "CreateFolderItem") function for more details. #### Example CreateFolderItem (item.wsdl) Request ```XML acme 7CDF678513DCBF0379DDD26A6961B604D7F1515CBD04 1234 2020-05-14T00:00:00 2 5 190 CZK 133629101 Repeated service Billing the yearly service. 130 5 139676101 6170 6787 10 100 2020-05-14T00:00:00 1 2020-05-14T00:00:00 2099-05-04T00:00:00 139704101 2 ``` #### CreateFolderItem (Response) ```XML OK 0 139812101 ``` # Execute Workflow Actions Immediately In case your integration requires executing workflow actions immediately after your request, it is necessary to call **CheckWorkflowQueue** function that is part of **features.wsdl**. ```XML yourserver ---yoursessionstring--- ``` # Create New Marketing Trigger Marketing triggers are used to track any activity of the contact / public user, which have some meaning in your company sales or marketing process. The example below notifies Atollon about new phone number added to contact. Atollon may therefore create call task. #### Example Request ```XML acme 61A...DBD04 new-phone-number 132716101 139663101 www.yourcompany.com/product/page www.company.com/product/page Extranet user added new phone number 2020-07-31 12:00 1 ``` #### Example Response ```XML OK 400097101 ``` #### Fields Description
**Field name****Example****Description**
baseTypenew-phone-number url-visit goal-achieved Text identification of the marketing trigger (what actually happened)
contextId123456789000Identification of Folder ID, Project ID or Activity ID in Atollon's context structure. It is necessary to enter context ID in case it should be displayed in context Timeline.
contactId113456789000Identification of contact, who caused the trigger
urlhttps://yourcompany.atollon.com/pub/23423432Page that the contact visited (optional)
trackingCodeyourSuperCampaignXYZAny text string representing one particular campaign / marketing activity / message template
descriptionContact visited URLAny descriptive text that will be visible to Atollon users in Timeline
triggerDate2020-08-12 12:00When the trigger happened?
numberOfVisits45In case the target user is super active (or robot), we may want to avoid spamming Atollon with unnecessary records and aggregate page visits