Export zboží do XLSX

/api/v2/export/products

Vytvoří export zboží firmy do souboru XLSX. Soubor se uloží na serveru a najdete ho v aplikaci na obrazovce Import / Export. Odpověď obsahuje jen {"result":"success"}, samotný soubor nevrací. Vytvořený soubor lze použít pro import zboží (table=exports), takže export slouží i jako záloha stavu zboží.

Exportují se nesmazané produkty seřazené podle kódu. Parametr categories omezí výběr na produkty zařazené do některé z uvedených kategorií; produkt ve více kategoriích je v souboru jednou. Každé volání vytvoří nový soubor.

Soubor exportu

Název souboru má tvar {firma}_{uživatel}_zbozi_{RRRR_MM_DD_HH_MM_SS}.xlsx. Jediný list obsahuje hlavičku (názvy sloupců jsou v tabulce, většina je bez diakritiky) a jeden řádek na produkt. Měrné jednotky, měny, DPH, kategorie, sklady, ingredience a ceníky jsou uvedené kódy z nastavení firmy. Seznamy hodnot v jedné buňce jsou oddělené čárkou a jejich počty jsou ve stejném pořadí v sousedním sloupci.

Význam jednotlivých sloupců a povolené hodnoty (0 a 1 u příznaků) popisuje návod Import / Export. Stejné pořadí sloupců čte import zboží.

Odpověď

Úspěch je JSON s HTTP 200. Chyby přihlášení a chybně poslaný parametr categories vrací JSON s status a message, viz Chybové stavy.

curl -X POST 'https://www.elpokladny.cz/api/v2/export/products?categories=12%2C15' \
  -H 'Authorization: Bearer elp_live_example.example_secret'

<?php
$ch = curl_init('https://www.elpokladny.cz/api/v2/export/products?categories=12%2C15');
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/export/products?categories=12%2C15", {
    "method": "POST",
    "headers": {
        "Authorization": "Bearer elp_live_example.example_secret"
    }
});
const data = await response.json();

{
  "result": "success"
}

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

{
  "status": "error",
  "message": "Input value \"categories\" contains a non-scalar value."
}