Obohacení
Zveřejňování a zařazování
Požadováno za každý dokument
Podpůrný stupeň
Zachycení
PDF faktury do strukturovaných dat
Taxonomie
UNSPSC
Výsledky vrácené podle ID produktu
Zpracování
Asynchronní
Zjišťování stavu maximálně každých 30 sekund
Dvě obohacení s využitím zachycování jako podpory
Zadávání a zařazování představují obohacení. Získávání dat je krok, který přemění fakturu ve formátu PDF na strukturovaná data, aby bylo možné provést oba tyto procesy.
Návrhy na příspěvky
Doporučené zaúčtování pro každý řádek dodavatelské faktury, vygenerované na základě historie zaúčtování vaší organizace. Váš tým každý návrh potvrzuje.
Klasifikace výrobků
Kódy UNSPSC pro položky faktur a pro produkty z katalogů a ceníků, přičemž každý z nich je opatřen vaším vlastním identifikačním číslem.
Zachycení jako podpora
Když dorazí faktura ve formátu PDF, systém nejprve extrahuje údaje z hlavičky a jednotlivých položek, aby měl systém pro zaúčtování a klasifikaci k dispozici strukturovaná data.
Shromáždit výsledky
Každý dotaz vrátí identifikátor dotazu. Shromažďujte výsledky podle jednotlivých typů obohacení, přičemž dotazujte nejvýše jednou za 30 sekund.
Rozdělte seznam produktů do dvou požadavků
Zašlete názvy produktů spolu s vašimi vlastními identifikátory, například položky z katalogu, ceníku nebo vašeho registru položek. V odpovědi obdržíte identifikátor dotazu a výsledek vrátí každý identifikátor produktu spolu s jeho klasifikací podle UNSPSC.
- ID vašich produktů se ve výsledku zobrazí
- Ověřte se pomocí klíče API nebo tokenu JWT z rozhraní API účtu
- Provádějte dotazování nejvýše jednou za 30 sekund
- Oddělené základní adresy URL pro testovací a produkční prostředí
● ● ●
Žádost v testovacím prostředí: klasifikace produktů
curl -X POST \
"https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/categorisation" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"enrichmentTypes": "unspsc",
"products": [
{ "id": 1, "product_name": "Nitrile gloves, size M" },
{ "id": 2, "product_name": "A4 copy paper, 80 g" }
]
}'
# Collect the result with the pollingId
curl "https://api-test.qvalia.com/enrichment/$ACCOUNT_REG_NO/$POLLING_ID" \
-H "Authorization: $QVALIA_API_KEY"Cíle obohacení
Všechny cesty jsou relativní vůči základní URL pískoviště nebo produkčního prostředí a jsou vázány na registrační číslo vašeho účtu.
| Žádost | Koncový bod | Vrácení zboží |
| Doplnit fakturu | POST /enrichment/{accountRegNo}/invoice | ID ankety |
| Klasifikovat produkty | POST /enrichment/{accountRegNo}/categorisation | ID ankety |
| Zobrazit všechny výsledky | GET /enrichment/{accountRegNo}/{pollingId} | Stav, resp. výsledky podle typu |
| Zobrazit jeden výsledek | GET /enrichment/{accountRegNo}/{pollingId}/{enrichmentType} | Výsledek snímání, zařazení nebo klasifikace |
Pískoviště: api-test.qvalia.com. Produkce: api.qvalia.com. Služba Enrichment API se účtuje samostatně a podpora Qvalia zajišťuje aktivaci obohacení, která váš účet využívá.
Kdy se používají obohacená data
Zadávání návrhů a kódů UNSPSC slouží jako podklad pro další procesy, a to buď na vaší vlastní platformě, nebo v systému Qvalia.
- Závazky
Potvrzené kódování účtů se přenáší spolu s fakturou do schvalovacího procesu a při zaúčtování. - Katalogy a ceníky
Doplňte položky v katalogu a ceníku, u nichž chybí kód UNSPSC. - Analýza výdajů
Kódy UNSPSC vám umožňují seskupovat nákupy podle segmentů, skupin a tříd napříč dodavateli. - Vaše vlastní platforma
Zobrazujte uživatelům návrhy a klasifikace ve vašem vlastním rozhraní.
Vyberte si výchozí bod
Zveřejnění
Účetní API
Jak váš tým školí, kontroluje a schvaluje návrhy příspěvků.
Údaje o produktu
Klasifikace UNSPSC
Jak společnost Qvalia klasifikuje položky faktur a údaje o produktech pomocí UNSPSC.
Zachycení
OCR API
Samotný proces pořízení, včetně bezplatného testu pro vaši vlastní fakturu ve formátu PDF.
Často kladené otázky k rozšiřujícímu API
Co je to rozhraní Enrichment API?
REST API se dvěma doplňkovými funkcemi: návrhy zaúčtování dodavatelských faktur a klasifikace fakturačních položek a produktů podle UNSPSC. Capture je podpůrný krok, který před zaúčtováním a klasifikací převádí faktury ve formátu PDF na strukturovaná data.
Proč je zachycení podpůrným krokem?
Zpracování a klasifikace strukturovaných dat. Faktury doručené ve formátu Peppol nebo jako jiné dokumenty XML již tato data obsahují. Faktura ve formátu PDF se nejprve naskenuje, aby bylo možné zaúčtovat a klasifikovat její hlavičkové údaje a jednotlivé položky. Skenování je také možné provést samostatně prostřednictvím rozhraní OCR API.
Jak fungují návrhy na příspěvky?
Jsou trénovány na fakturách, které vaše organizace již zaúčtovala. Ke každé nové dodavatelské faktuře se pro každou položku navrhne zaúčtování a váš tým jej potvrdí. Více informací najdete na stránce Účetní API.
Mohu katalogy a ceníky zařadit do kategorií?
Ano. Žádost o zařazení vyžaduje seznam produktů, z nichž každý obsahuje vlastní ID a název produktu, takže položky z katalogu, ceníku, evidence zboží nebo fakturačních řádků se odesílají stejným způsobem.
Jakou taxonomii využívá klasifikace?
UNSPSC. Výsledek obsahuje ID každého produktu spolu s jeho klasifikací, takže jej můžete přiřadit ke svým vlastním záznamům.
Je tam pískoviště?
Ano. Pro testování použijte adresu api-test.qvalia.com a pro produkční provoz adresu api.qvalia.com.
Je rozhraní Enrichment API součástí jiných rozhraní API Qvalia?
Ne. Rozhraní Enrichment API se účtuje samostatně a vyžaduje dodatečná oprávnění. Podpora Qvalia aktivuje obohacení, která váš účet využívá.
