{"id":7332,"date":"2017-11-27T12:26:06","date_gmt":"2017-11-27T11:26:06","guid":{"rendered":"https:\/\/www.minicrm.hu\/help\/?p=7332"},"modified":"2017-11-27T12:26:06","modified_gmt":"2017-11-27T11:26:06","slug":"custom-webshop-integration","status":"publish","type":"post","link":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/","title":{"rendered":"Custom webshop integration"},"content":{"rendered":"
1 Webshop<\/a> term\u00e9ke can be used in a MiniCRM system.<\/div>\n

To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that has a specific format and is generated from the webshop’s database. You can create the file according to the Sample<\/a>.<\/p>\n

The other system prepares a file in XML format. MiniCRM downloads and processes it in reaction to an API call. MiniCRM updates the already existing data and creates new ones if it is necessary. There is no need to resend all opportunity cards\/fields by every sync because MiniCRM can accept XML files that contain only modified data as well.<\/p>\n

The MiniCRM XML reader is project-based. One ‘Project’ contains one order and data that belongs to it. In case of more than one order, they have to appear below each other.<\/p>\n

Basic card information has to be entered directly below the Project node (the bold lines are required, the other ones are optional):
\n\u2018Project Id\u2019<\/strong>\u00a0– the Id of the card. Later on, a person’s card can be updated based on this Id.
\n\u2018Name\u2019<\/strong>\u00a0– the card’s name (it is practical if the card’s name equals to the customer’s name)
\n\u2018CategoryId\u2019<\/strong>\u00a0– the Id of the term\u00e9ke (it is always the Id of the Webshop term\u00e9ke. You can find it in the Webshop term\u00e9ke, at the end of the URL following the \u2018#!Project-‘ part.
\n\u2018StatusId\u2019<\/strong>\u00a0–\u00a0the name of the status to which the card will be added (it is enough to enter the ‘Registered’ value because the card will move between the statuses according to the status rules of the Webshop term\u00e9ke)
\n\u2018UserId\u2019 –\u00a0the name of the MiniCRM user who will be the owner of the given card<\/em>
\n\u2018WebshopRegistrationDate\u2019 – the date when the customer has registered for the webshop
\n\u2018Webshop<\/em>Disabled\u2019 – its value can be 0\/1, if it is 1, the customer is Disabled\/Deleted<\/em>
\n\u2018WebshopLostBasketContent\u2019 –\u00a0the content of the last abandoned cart
\n\u2018Webshop<\/em>LostBasketDate\u2019 –\u00a0the<\/em>\u00a0date of the last abandoned cart<\/em>
\n\u2018WebshopLostBasketValue\u2019 – the value of the last abandoned cart
\n\u2018Webshop<\/em>AllLostBasket\u2019 –\u00a0the value of all abandoned carts<\/em><\/p>\n

If no UserId is given, the central owner of the system will be set on the Projects.<\/div>\n

After that comes the data of the company\/person and contact persons. It has to be placed directly below the Project node. It is possible to send companies and persons to MiniCRM and add contact persons to companies via XML. At least one company’s or person’s data has to appear in this part:<\/p>\n

Business:<\/strong>
\n\u2018Name\u2019<\/strong>\u00a0– the company’s name
\n\u2018Email\u2019 – the company’s email address<\/p>\n

Contact:
\n\u2018FirstName\u2019 – the first name of the person\/company’s contact person
\n\u2018LastName\u2019 – the last name of\u00a0the person\/company’s contact person
\n\u2018Email\u2019 – the email address of the person\/company’s contact person<\/p>\n

If there is no company, strictly one person can be added.<\/div>\n

After that, you have to add information regarding the order. These data will be added to the Order term\u00e9ke<\/a> already (irrespective of the fact whether you have given the Webshop term\u00e9ke<\/a>‘s Id as\u00a0\u2018CategoryId\u2019 in the beginning of the XML or not).<\/p>\n

\u2018Order Id\u2019<\/strong>\u00a0– the order’s Id
\n\u2018Number\u2019<\/strong>\u00a0– the name of the card in the Order term\u00e9ke
\n\u2018CurrencyCode\u2019<\/strong>\u00a0– the currency code of the order
\n\u2018Performance\u2019<\/strong>\u00a0– the performance date
\n\u2018Subject\u2019 – a note regarding the order
\n\u2018Status\u2019<\/strong>\u00a0– the order’s status<\/p>\n

It is followed by the customer’s data:<\/p>\n

\u2018Name\u2019<\/strong>\u00a0– the customer’s name
\n\u2018CountryId\u2019<\/strong>\u00a0– the customer’s country
\n\u2018PostalCode\u2019<\/strong>\u00a0– the customer’s postal code
\n\u2018City\u2019<\/strong>\u00a0– the customer’s city
\n\u2018Address\u2019<\/strong>\u00a0– the customer’s address<\/p>\n

Finally comes the data of the ordered product(s)<\/p>\n

\u2018Product Id\u2019<\/strong>\u00a0– the product’s Id
\n\u2018Name\u2019<\/strong>\u00a0– the product’s name
\n\u2018SKU\u2019 – the product’s SKU code
\n\u2018EAN\u2019 -the product’s EAN code
\n\u2018PriceNet\u2019<\/strong>\u00a0– the product’s net price
\n\u2018Quantity\u2019<\/strong>\u00a0– the quantity of the product
\n\u2018Unit\u2019<\/strong>\u00a0– the unit of the product
\n\u2018VAT\u2019<\/strong>\u00a0– the extent of the VAT
\n\u2018FolderName\u2019<\/strong>\u00a0– the name of the folder in MiniCRM to which the products have to be added<\/p>\n

If you have added every required data regarding an order, the ‘Project’ can be closed and you can continue to work on the next one. By using\u00a0XML sync<\/a>, you can even update millions of cards.<\/p>\n","protected":false},"excerpt":{"rendered":"

1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that has a specific format and is generated from the webshop’s database. You can create the file according to the Sample. The other system prepares a file in XML […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[383],"tags":[422,480],"class_list":["post-7332","post","type-post","status-publish","format-standard","hentry","category-more-import-export-and-form","tag-api-en","tag-webshop-en"],"yoast_head":"\nCustom webshop integration - Documenta\u021bie MiniCRM<\/title>\n<meta name=\"description\" content=\"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Custom webshop integration - Documenta\u021bie MiniCRM\" \/>\n<meta property=\"og:description\" content=\"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that\" \/>\n<meta property=\"og:url\" content=\"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/\" \/>\n<meta property=\"og:site_name\" content=\"Documenta\u021bie MiniCRM\" \/>\n<meta property=\"article:published_time\" content=\"2017-11-27T11:26:06+00:00\" \/>\n<meta name=\"author\" content=\"L\u00edvia F\u00fcl\u00f6p\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"L\u00edvia F\u00fcl\u00f6p\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/\"},\"author\":{\"name\":\"L\u00edvia F\u00fcl\u00f6p\",\"@id\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/#\\\/schema\\\/person\\\/ceb677e9c50c3b41ea1539b92acfae96\"},\"headline\":\"Custom webshop integration\",\"datePublished\":\"2017-11-27T11:26:06+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/\"},\"wordCount\":739,\"commentCount\":0,\"keywords\":[\"api-en\",\"webshop-en\"],\"articleSection\":[\"More Import Export and Form\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/\",\"url\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/\",\"name\":\"Custom webshop integration - Documenta\u021bie MiniCRM\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/#website\"},\"datePublished\":\"2017-11-27T11:26:06+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/#\\\/schema\\\/person\\\/ceb677e9c50c3b41ea1539b92acfae96\"},\"description\":\"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/helpdev.minicrm.io\\\/help\\\/custom-webshop-integration\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Custom webshop integration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/#website\",\"url\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/\",\"name\":\"Documenta\u021bie MiniCRM\",\"description\":\"Welcome to MiniCRM\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.minicrm.hu\\\/help\\\/#\\\/schema\\\/person\\\/ceb677e9c50c3b41ea1539b92acfae96\",\"name\":\"L\u00edvia F\u00fcl\u00f6p\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g\",\"caption\":\"L\u00edvia F\u00fcl\u00f6p\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Custom webshop integration - Documenta\u021bie MiniCRM","description":"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/","og_locale":"en_US","og_type":"article","og_title":"Custom webshop integration - Documenta\u021bie MiniCRM","og_description":"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that","og_url":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/","og_site_name":"Documenta\u021bie MiniCRM","article_published_time":"2017-11-27T11:26:06+00:00","author":"L\u00edvia F\u00fcl\u00f6p","twitter_card":"summary_large_image","twitter_misc":{"Written by":"L\u00edvia F\u00fcl\u00f6p","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/#article","isPartOf":{"@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/"},"author":{"name":"L\u00edvia F\u00fcl\u00f6p","@id":"https:\/\/www.minicrm.hu\/help\/#\/schema\/person\/ceb677e9c50c3b41ea1539b92acfae96"},"headline":"Custom webshop integration","datePublished":"2017-11-27T11:26:06+00:00","mainEntityOfPage":{"@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/"},"wordCount":739,"commentCount":0,"keywords":["api-en","webshop-en"],"articleSection":["More Import Export and Form"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/","url":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/","name":"Custom webshop integration - Documenta\u021bie MiniCRM","isPartOf":{"@id":"https:\/\/www.minicrm.hu\/help\/#website"},"datePublished":"2017-11-27T11:26:06+00:00","author":{"@id":"https:\/\/www.minicrm.hu\/help\/#\/schema\/person\/ceb677e9c50c3b41ea1539b92acfae96"},"description":"1 Webshop term\u00e9ke can be used in a MiniCRM system. To display data from your custom-developed webshop in your MiniCRM system, you need an XML file that","breadcrumb":{"@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/helpdev.minicrm.io\/help\/custom-webshop-integration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.minicrm.hu\/help\/"},{"@type":"ListItem","position":2,"name":"Custom webshop integration"}]},{"@type":"WebSite","@id":"https:\/\/www.minicrm.hu\/help\/#website","url":"https:\/\/www.minicrm.hu\/help\/","name":"Documenta\u021bie MiniCRM","description":"Welcome to MiniCRM","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.minicrm.hu\/help\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.minicrm.hu\/help\/#\/schema\/person\/ceb677e9c50c3b41ea1539b92acfae96","name":"L\u00edvia F\u00fcl\u00f6p","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/f3134b1be47aa2326a775dd7090fd53fb8a694a561ad9cc5ec8f1e66ff8bacc4?s=96&d=mm&r=g","caption":"L\u00edvia F\u00fcl\u00f6p"}}]}},"_links":{"self":[{"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/posts\/7332","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/comments?post=7332"}],"version-history":[{"count":2,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/posts\/7332\/revisions"}],"predecessor-version":[{"id":7344,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/posts\/7332\/revisions\/7344"}],"wp:attachment":[{"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/media?parent=7332"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/categories?post=7332"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.minicrm.hu\/help\/wp-json\/wp\/v2\/tags?post=7332"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}