{"_id":"5b9289deb10f0b0003703767","project":"56e29a8dd3b68d0e00b48ffa","version":{"_id":"56e29a8dd3b68d0e00b48ffd","hasReference":true,"project":"56e29a8dd3b68d0e00b48ffa","__v":15,"hasDoc":true,"createdAt":"2016-03-11T10:14:37.460Z","releaseDate":"2016-03-11T10:14:37.460Z","categories":["56e29a8ed3b68d0e00b48ffe","56eb917a2e58011700afdfcc","56eb92252109011700f3ba5e","5704d4af849f721900f27835","57052a31473f900e004d5d54","5715222811537f19006aab2d","5715b57b810df00e00cc7832","5715baa9810df00e00cc7837","57180ed83a17770e009a7322","571810273a17770e009a7325","579b22d3f4ad7b190094b60e","584538ecba4f1c0f0096925e","586bb88e5602870f00ae7177","5a70407fb0a01400369583c5","5ace359e40606a0003eac1de"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"category":{"_id":"56eb917a2e58011700afdfcc","version":"56e29a8dd3b68d0e00b48ffd","pages":[],"project":"56e29a8dd3b68d0e00b48ffa","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-03-18T05:26:18.963Z","from_sync":false,"order":2,"slug":"company-information","title":"Companies"},"user":"58bedd212710c31b004150db","__v":9,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-09-07T14:23:26.685Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{\n\t“ConfirmationId”:\"141571966\",\n\t“ExternalId”: {\n\t\t“Id”:\"CH-550.1.037.847-1\",\n\t\t“Service”: \"COCCH\"\n\t},\n\t“CountryCode”:\"CH\"\n}","name":""},{"code":"{\n\t“Code”: 5001,\n\t“Message”: “Company not found.”,\n\t“HttpStatusCode”: 404\n}","language":"text","status":404},{"code":"{\n\t“Code”: 5003,\n\t“Message”: “Company already exists.”,\n\t“HttpStatusCode”: 409\n}\n","language":"text","status":409}]},"settings":"","examples":{"codes":[{"code":"{\n\t\"ExternalId\":{\n\"Service\":\"COCCH\"\t\n\"Id\": \"CH-550.1.037.847-1\"\n},\n\"CountryCode\":\"CH\"\n}\n\n\n","language":"json"}]},"method":"post","auth":"required","params":[{"_id":"5b9290f3b10f0b000370386e","ref":"","in":"body","required":false,"desc":"JSON containing the external Id of the company (Service and Id) and county code","default":"","type":"object","name":"body"},{"_id":"5b9290f3b10f0b000370386d","ref":"","in":"header","required":false,"desc":"Your CompanyCreation API Key, in the HTTP request headers.","default":"","type":"string","name":"apikey"}],"url":"/company"},"isReference":true,"order":7,"body":"In order to be able to request a cover on an invoice, both SICIDs sellerId and buyerId need to be provided in the request.\n\nWhen performing a company search, if the company is known in our system the API will return its SICID but if not, an empty SICID in the format \"00000000-0000-0000-0000-000000000000\" is returned and in that case this service can be called to created the company.\n\nThe company creation service will be done in 2 steps:\n\n1. Request the company creation in SIC for a specific External Id (the endpoint on this page) . \nThe API will start the asynchronous company creation process and return a request confirmation Id.\n\n2. Check the progress of the creation request and retrieve the SICID of the newly created company\n- If the company is graded and created in SIC, it’s SICID is returned\n- If the company is not yet created in SIC, a pending status is returned","excerpt":"Request the creation of a company in case the company search didn't return the SICID of a company but returned one of its external IDs.","slug":"company-creation-in-sic-by-external-id","type":"endpoint","title":"Request SIC Company Creation by External Id"}

postRequest SIC Company Creation by External Id

Request the creation of a company in case the company search didn't return the SICID of a company but returned one of its external IDs.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

body:
object
JSON containing the external Id of the company (Service and Id) and county code

Headers

apikey:
string
Your CompanyCreation API Key, in the HTTP request headers.

Examples


Result Format


Documentation

In order to be able to request a cover on an invoice, both SICIDs sellerId and buyerId need to be provided in the request. When performing a company search, if the company is known in our system the API will return its SICID but if not, an empty SICID in the format "00000000-0000-0000-0000-000000000000" is returned and in that case this service can be called to created the company. The company creation service will be done in 2 steps: 1. Request the company creation in SIC for a specific External Id (the endpoint on this page) . The API will start the asynchronous company creation process and return a request confirmation Id. 2. Check the progress of the creation request and retrieve the SICID of the newly created company - If the company is graded and created in SIC, it’s SICID is returned - If the company is not yet created in SIC, a pending status is returned