Import kontaktů ze souboru XLSX

/api/v2/import/contacts

Načte tabulku XLSX, která už je na serveru, a zpracuje z ní kontakty firmy. Pro každý řádek (hlavičku na prvním řádku přeskočí) hledá nesmazaný kontakt firmy se shodným e-mailem. Když ho najde, upraví ho podle řádku, jinak založí nový.

Odkud se bere soubor

Operace nepřijímá soubor v těle požadavku. Pracuje se souborem, který už je na serveru, a najde ho podle dvojice file a table v rámci vaší firmy:

• table=imports: soubor dříve nahraný k importu, například v aplikaci na obrazovce Import / Export.
• table=exports: soubor vytvořený exportem kontaktů.

Postup v aplikaci popisuje návod Import / Export.

Co se v souboru čte

Čte se první (aktivní) list, sloupce A až V ve stejném pořadí, v jakém je vytváří export kontaktů (sloupec W s ID se ignoruje). Řádek se zpracuje, jen když je vyplněný sloupec A (Typ), B (Jmeno) a H (E-mail) a e-mail obsahuje @. Ostatní sloupce se uloží jako text, prázdná buňka je prázdný řetězec.

Odpověď

Úspěšné zpracování je HTTP 200 s Content-Type: text/html; charset=UTF-8. Tělo není JSON, ale text, kde každý řádek končí <br />:

• INSERTED: {jméno} - kontakt byl založen,
• UPDATED: {jméno} - existující kontakt byl upraven,
• ERROR: INVALID ROW ({číslo řádku}) - ( ... ) - řádek se přeskočil, uvádí chybějící sloupce,
• No rows processed - v souboru nebyl žádný datový řádek.

Chybný řádek zpracování nezastaví a odpověď má i tak HTTP 200, proto čtěte tělo. Řádky se ukládají postupně, dříve zpracované řádky zůstanou uložené i při chybě v pozdějším řádku. Selhání před zpracováním (neplatné parametry, soubor nenalezen nebo nečitelný) vrací HTTP 400 nebo 404 s Content-Type: text/plain; charset=UTF-8 a textem začínajícím ERROR:. Chyby přihlášení vrací JSON se status a message. Viz Chybové stavy.

curl -X POST 'https://www.elpokladny.cz/api/v2/import/contacts?file=12&table=imports' \
  -H 'Authorization: Bearer elp_live_example.example_secret'

<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/import/contacts?file=12&table=imports');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => array (
  0 => 'Authorization: Bearer elp_live_example.example_secret',
),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

const response = await fetch("https://www.elpokladny.cz/api/v2/import/contacts?file=12&table=imports", {
    "method": "POST",
    "headers": {
        "Authorization": "Bearer elp_live_example.example_secret"
    }
});
const data = await response.json();

INSERTED: Jana Ukázková<br />UPDATED: Ukázkový odběratel s.r.o.<br />ERROR: INVALID ROW (4) - ( B - jmeno,  )<br />

ERROR: file not found

ERROR: invalid parameters

{
  "status": "error",
  "message": "Unauthorized"
}