Cez REST API je od verzie 2021.9 možné fakturovať príjemku či výdajku — teda vytvoriť zo skladového dokladu prijatú alebo vydanú faktúru.

Spôsob volania

Požiadavka sa posiela metódou POST alebo PUT na evidenciu danej faktúry:

POST https://demo.flexibee.eu/c/demo/faktura-vydana.xml

V tele faktúry uvediete element fakturuj s týmito vlastnosťami:

skladovyDokl — povinný identifikátor skladového dokladu, ktorý sa má fakturovať
prenestSlevu — nepovinná hodnota true, ak má byť použitá zľava z objednávky

⚠️ Do tela faktúry uvádzajte iba povinné vlastnosti, ako je typDokl, cisDosle a datSplat. Ostatné vlastnosti môžu byť prepísané dátami z príjemky alebo výdajky. Neexistujúci skladový doklad vracia 400 s kódom importXmlNotFoundForIdentifier.

Príklady použitia

Fakturácia príjemky

<winstrom version="1.0">
  <faktura-prijata>
    <id>ext:FAP</id>
    <typDokl>code:FAKTURA</typDokl>
    <cisDosle>123</cisDosle>
    <datSplat>2024-07-14</datSplat>
    <fakturuj>
      <skladovyDokl>ext:PRIJEMKA123</skladovyDokl>
    </fakturuj>
  </faktura-prijata>
</winstrom>

Fakturácia výdajky

<winstrom version="1.0">
  <faktura-vydana>
    <id>ext:FAV</id>
    <typDokl>code:FAKTURA</typDokl>
    <fakturuj>
      <skladovyDokl>ext:VYDEJ123</skladovyDokl>
    </fakturuj>
  </faktura-vydana>
</winstrom>

Fakturácia výdajky s aplikáciou zľavy z objednávky

<winstrom version="1.0">
  <faktura-vydana>
    <id>ext:FAV</id>
    <typDokl>code:FAKTURA</typDokl>
    <fakturuj>
      <skladovyDokl>ext:VYDEJ123</skladovyDokl>
      <prenestSlevu>true</prenestSlevu>
    </fakturuj>
  </faktura-vydana>
</winstrom>

To isté v JSON

{
  "winstrom": {
    "@version": "1.0",
    "faktura-vydana": {
      "id": "ext:FAV",
      "typDokl": "code:FAKTURA",
      "fakturuj": {
        "skladovyDokl": "ext:VYDEJ123"
      }
    }
  }
}

Hromadná fakturácia príjemok a výdajok

API umožňuje aj hromadnú fakturáciu — zaistíte ju opakovaním volania služby fakturuj v jednej požiadavke pod rovnakým externým identifikátorom faktúry.

Príklad v JSON

Fakturácia dvoch skladových príjemok do jednej prijatej faktúry vrátane sprievodných informácií pre faktúru:

{
  "winstrom": {
    "@version": "1.0",
    "faktura-prijata": [
      {
        "id": "ext:ESHOP:1234",
        "typDokl": "code:FAKTURA",
        "firma": "641",
        "datVyst": "2024-09-16",
        "duzpPuv": "2024-09-16",
        "datSplat": "2024-09-30",
        "duzpUcto": "2024-09-16",
        "varSym": "703000106",
        "szbDphSniz": 12.0,
        "szbDphZakl": 21.0,
        "formaUhradyCis": "code:HOTOVĚ",
        "cisDosle": "1",
        "fakturuj": {
          "skladovyDokl": "1",
          "prenestSlevu": true
        }
      },
      {
        "id": "ext:ESHOP:1234",
        "fakturuj": {
          "skladovyDokl": "2",
          "prenestSlevu": true
        }
      },
      {
        "id": "ext:ESHOP:1234",
        "@removeExternalIds": "ext:ESHOP",
        "fakturuj": {
          "skladovyDokl": "3",
          "prenestSlevu": true
        }
      }
    ]
  }
}

Príklad v XML

<?xml version="1.0" encoding="UTF-8" ?>
<winstrom version="1.0">
  <faktura-prijata>
    <id>ext:ESHOP:1234</id>
    <typDokl>code:FAKTURA</typDokl>
    <firma>641</firma>
    <datVyst>2024-09-16</datVyst>
    <duzpPuv>2024-09-16</duzpPuv>
    <datSplat>2024-09-30</datSplat>
    <duzpUcto>2024-09-16</duzpUcto>
    <varSym>1</varSym>
    <cisDosle>1</cisDosle>
    <fakturuj>
      <skladovyDokl>1</skladovyDokl>
      <prenestSlevu>true</prenestSlevu>
    </fakturuj>
  </faktura-prijata>
  <faktura-prijata>
    <id>ext:ESHOP:1234</id>
    <fakturuj>
      <skladovyDokl>2</skladovyDokl>
      <prenestSlevu>true</prenestSlevu>
    </fakturuj>
  </faktura-prijata>
  <faktura-prijata removeExternalIds="ext:ESHOP">
    <id>ext:ESHOP:1234</id>
    <fakturuj>
      <skladovyDokl>3</skladovyDokl>
      <prenestSlevu>true</prenestSlevu>
    </fakturuj>
  </faktura-prijata>
</winstrom>

ℹ️ Externý identifikátor v poslednom bloku sa odstraňuje atribútom removeExternalIds, respektíve vlastnosťou @removeExternalIds v JSON. Bez toho by faktúra zostala naviazaná na externý identifikátor ext:ESHOP:1234 a ďalšie hromadné volanie by ju našlo a upravilo.

Súvisiace

Sorodni članki

Fakturácia skladového pohybu cez REST API

Spôsob volania

Príklady použitia

Hromadná fakturácia príjemok a výdajok

Súvisiace