Integrari + API

Integrari simple intre Oblio si alte aplicatii folosite in firma ta.
Documentatie usoara, suport tehnic prompt. Oblio este iubit si de programatori.

Prezentare generala

Scopul API

Oblio pune la dispozitie pentru dezvoltatori un API cu ajutorul caruia puteti avea acces la diferite facilitati cum ar fi:

  • Vizualizare nomenclatoare;
  • Emitere proforme, avize, facturi, facturi pe baza de proforma sau aviz;
  • Vizualizare factura, proforma sau aviz;
  • Anulare factura, proforma sau aviz;
  • Restaurare factura, proforma sau aviz;
  • Stergere factura, proforma sau aviz;

Raspunsurile vin in format JSON, daca cererea a fost facuta cu succes se va trimite de catre server un cod de status 200, daca cererea nu este facuta cu succes se va trimite un cod de status 400 sau 401 cu un mesaj de eroare.

Pe pagina noastra de GitHub https://github.com/OblioSoftware veti gasi exemple de implementare ale API-ului.

Autorizare

Generare token de acces

https://www.oblio.eu/api/authorize/token - POST

Oblio REST API foloseste modulul OAuth 2.0 pentru autorizare. Acesta are nevoie de parametrul "client_id" care reprezinta email-ul cu care va autentificati in Oblio si "client_secret" care este un token pe care il gasiti in cont in sectiunea "Setari" > "Date Cont". Pentru securitate, token-ul "client_secret" se regenereaza de fiecare data cand se reseteaza parola. Pentru obtinerea token-ului de acces se trimite o cerere prin metoda "POST" impreuna cu parametrii "client_id" si "client_secret" catre adresa https://www.oblio.eu/api/authorize/token

Exemplu
curl -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=nume@exemplu.com&client_secret=1edd9e4f6..." -X POST https://www.oblio.eu/api/authorize/token
Raspuns
{
"access_token": "67d6f8817c28d698bdae35728c7a30b02a75bd4d",
"expires_in": "3600",
"token_type": "Bearer",
"scope": "",
"request_time": "1540471129"
}

Toate celelalte cereri catre Oblio REST API se fac folosind header-ul "Authorization" cu valoarea "Bearer {access_token}" unde {access_token} se obtine din cererea de mai sus.

Daca sunt mai mult de 3 cereri pe secunda token-ul de acces va fi blocat timp de 10 minute.

Nomenclatoare

Nomenclator companii

https://www.oblio.eu/api/nomenclature/companies - GET

Returneaza lista de companii asociate cu contul Oblio

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET https://www.oblio.eu/api/nomenclature/companies
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"cif": "RO37311090",
"company": "OBLIO SOFTWARE SRL",
"userTypeAccess": "admin"
}
]
}

Nomenclator cote TVA

https://www.oblio.eu/api/nomenclature/vat_rates - GET

Returneaza lista de cote TVA pentru o anumita firma

Parametru Explicatie
cif * CIF-ul firmei
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/vat_rates?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"name": "Normala",
"percent": 19,
"default": true
},
{
"name": "Redusa",
"percent": 9,
"default": false
},
{
"name": "SFDD",
"percent": 0,
"default": false
}
]
}

Nomenclator clienti

https://www.oblio.eu/api/nomenclature/clients - GET

Returneaza lista de clienti pentru o anumita firma

Parametru Explicatie
cif * CIF-ul firmei
name Numele clientului cautat
clientCif Ciful clientului cautat
offset Vor aparea initial maxim 250 de rezultate, este de preferat sa fie multiplu de 250 (0, 250, 500 etc.), valoarea implicita este 0
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/clients?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"cif": "RO37311090",
"name": "OBLIO SOFTWARE SRL",
"rc": "J13/887/2017",
"code": "",
"address": "",
"state": "Constanta",
"city": "Constanta",
"country": "",
"iban": "",
"bank": "",
"email": "",
"phone": "",
"contact": "",
"vatPayer": true
}
]
}

Nomenclator produse

https://www.oblio.eu/api/nomenclature/products - GET

Returneaza lista de produse pentru o anumita firma. Pentru servicii nu se tine cont de gestiunea unde se afla si deci nu apare rubrica "stock".

Parametru Explicatie
cif * CIF-ul firmei
name Numele produsului cautat
code Codul produsului cautat
management Gestiunea in care se face cautarea (La folosirea acestui parametru produsele vor aparea listate ca serviciile)
workStation Punctul de lucru al gestiunii in care se face cautarea
offset Vor aparea initial maxim 250 de rezultate, este de preferat sa fie multiplu de 250 (0, 250, 500 etc.), valoarea implicita este 0
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/products?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"name": "Montare",
"code": "",
"description": "",
"measuringUnit": "buc",
"productType": "Serviciu",
"price": "119.00",
"currency": "RON",
"vatName": "Normala",
"vatPercentage": 19,
"vatIncluded": true
},
{
"name": "Birou",
"code": "",
"description": "",
"measuringUnit": "buc",
"productType": "Marfa",
"stock": [
{
"workStation": "Sediu",
"management": "Magazin",
"quantity": 2,
"price": "200.00",
"currency": "RON",
"vatName": "Normala",
"vatPercentage": 19,
"vatIncluded": false
}
]
}
]
}

Nomenclator serii documente

https://www.oblio.eu/api/nomenclature/series - GET

Returneaza lista de serii documente pentru o anumita firma

Parametru Explicatie
cif * CIF-ul firmei
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/series?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"type": "Factura",
"name": "FCT",
"start": "0001",
"next": "0051",
"default": true
},
{
"type": "Proforma",
"name": "PR",
"start": "0001",
"next": "0008",
"default": true
}
]
}

Nomenclator limbi

https://www.oblio.eu/api/nomenclature/languages - GET

Returneaza lista de limbi straine pentru o anumita firma

Parametru Explicatie
cif * CIF-ul firmei
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/languages?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"code": "EN",
"name": "Engleza"
},
{
"code": "FR",
"name": "Franceza"
}
]
}

Nomenclator gestiuni

https://www.oblio.eu/api/nomenclature/management - GET

Returneaza lista de gestiuni pentru o anumita firma, functioneaza doar daca sunt activate stocurile

Parametru Explicatie
cif * CIF-ul firmei
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/management?cif=RO37311090"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"management": "Magazin",
"workStation": "Sediu",
"managementType": "Cantitativ Valorica"
},
{
"management": "Mobila",
"workStation": "Depozit",
"managementType": "Cantitativ Valorica"
}
]
}

Emitere documente

Emitere proforma

Emiterea de documente folosind Oblio REST API se face prin metoda POST trimitand datele in forma RAW in format JSON.

https://www.oblio.eu/api/docs/proforma - POST

Emiterea proformelor se face cu urmatorii parametrii:

Parametri document
Parametru Explicatie
cif * CIF-ul firmei de unde se emit facturi. Il gasiti la Oblio.eu > Setari > Date firma
client * Necesita anumiti parametri. Acestia se gasesc in zona "Parametri client"
issueDate Data emiterii in format AAAA-LL-ZZ, valoare implicita este ziua curenta
dueDate Data scadentei in format AAAA-LL-ZZ
seriesName * Nume serie document (se gaseste in nomenclator serii documente)
language Codul de limba in care se emite factura (se gasesc limbile disponibile in nomenclator), valoarea implicita este "RO"
precision Precizia documentului. Trebuie sa fie un numar intreg cu valoarea intre 2 si 4, valoarea implicita este 2
currency Moneda documentului, valoarea implicita este "RON"
exchangeRate Rata de schimb in cazul documentelor in valuta, valoare implicita este cursul setat in setarile companiei
products Este un tablou cu produse. Parametrii pentru produse se gasesc in zona "Parametri produs"
issuerName Intocmit de
issuerId CNP-ul celui care a intocmit documentul
noticeNumber Nr. aviz insotire
internalNote Nota interna (nu va fi vizibila pentru client)
deputyName Delegat
deputyIdentityCard Carte Identitate delegat
deputyAuto Auto delegat
selesAgent Agent vanzari
mentions Mentiuni
workStation Punct de lucru. Este valabil doar dupa activarea stocurilor, valoarea implicita este "Sediu"
sendEmail Daca are valoarea 1 se va trimite email-ul de la Setari > E-mail-uri alarma > Document prin email

Parametri client
Parametru Explicatie
cif CIF-ul firmei sau CNP-ul clientului
name * Numele (pentru persoanelor fizice) sau a numele firmei (pentru persoane juridice)
rc Numar Registru Comert
code Cod client
address Adresa
state Judet
city Oras
country Tara
iban IBAN
bank Banca
email Email
phone Numar de telefon
contact Persoana de contact
vatPayer Platitor de TVA, ia valorile 0 sau 1
save Sa schimbe sau nu datele clientului, ia valorile 0 sau 1. Valoarea implicita este 0
autocomplete Daca este completat parametrul "cif" cu o firma din Romania, datele se preiau automat, ia valorile 0 sau 1. Valoarea implicita este 0

Parametri produs
Parametru Explicatie
name * Numele produsului
code Codul produsului
description Descrierea
price * Pretul
measuringUnit Unitatea de masura a produsului, valoarea implicita este "buc"
currency Moneda
exchangeRate Rata de schimb a monezii in cazul in care aceasta este diferita de moneda documentului
vatName Numele cotei de TVA (se gaseste in nomenclator cote TVA)
vatPercentage Procentul cotei de TVA (se gaseste in nomenclator cote TVA)
vatIncluded TVA-ul este inclus in pretul produsului, ia valorile 0 sau 1, valoarea implicita este 1
quantity Cantitatea, valoare implicita este 1
management Numele gestiunii din care face parte produsul. Este valabil doar dupa activarea stocurilor pentru produse stocabile (nu este valabil pentru servicii)
productType Tip produs. Trebuie sa fie unul din "Marfa", "Materii prime", "Materiale consumabile", "Semifabricate", "Produs finit", "Produs rezidual", "Produse agricole", "Animale si pasari", "Ambalaje", "Obiecte de inventar", "Serviciu". Este valabil doar dupa activarea stocurilor
nameTranslation Numele produsului tradus (daca este cazul pentru facturile in alte limbi decat romana)
measuringUnitTranslation Unitatea de masura tradusa (daca este cazul pentru facturile in alte limbi decat romana)
save Salveaza pretul de lista. Poate sa fie 0 sau 1. Valoarea implicita este 1

Discounturi

Sunt elemente in lista de produse si au urmatorii parametrii:

Parametru Explicatie
name * Numele care apare in dreptul discountului
discountType Discount procentual sau valoric, ia valorile "procentual" sau "valoric", valoarea implicita este "valoric"
discount * Valoare discount
discountAllAbove Ia valoarea 1 daca este valabil pentru toate produsele fara discount dinaintea sa sau 0 doar pentru primul produs de deasupra sa, valoarea implicita este 0

Exemplu de fisier JSON
{
"cif": "RO37311090",
"client": {
"cif": "RO37311090",
"name": "OBLIO SOFTWARE SRL",
"rc": "J13/887/2017",
"code": "oblio",
"address": "",
"state": "Constanta",
"city": "Constanta",
"country": "",
"iban": "",
"bank": "",
"email": "",
"phone": "",
"contact": "",
"vatPayer": true
},
"issueDate": "2018-10-15",
"dueDate": "2018-10-30",
"seriesName": "PR",
"language": "RO",
"precision": 2,
"currency": "RON",
"products": [
{
"name": "Test",
"code": "test",
"description": "Descriere de test",
"price": 200,
"measuringUnit": "buc",
"vatName": "Normala",
"vatPercentage": 19,
"vatIncluded": 0,
"quantity": 2,
"productType": "Serviciu",
"management": "Magazin"
},
{
"name": "Discount 10% Test",
"discount": 10,
"discountType": "procentual"
}
],
"issuerName": "Ion Popescu",
"issuerId": 1234567890123,
"noticeNumber": "AVZ 0041",
"internalNote": "Proforma emisa din API",
"deputyName": "George Popescu",
"deputyIdentityCard": "ID 1234",
"deputyAuto": "CT 12345",
"selesAgent": "Marian Popescu",
"mentions": "Proforma de test emisa din API",
"workStation": "Sediu"
}
Exemplu de creare proforma
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -d @proforma.json -X POST https://www.oblio.eu/api/docs/proforma
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": {
"seriesName": "PR",
"number": "0008",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261747&it=b8590b71a702ab3788f0dda5d5c77d23"
}
}

Emitere avize

https://www.oblio.eu/api/docs/notice - POST

Emiterea avizelor se face identic cu emiterea proformelor cu diferenta ca avizele nu au parametrul "noticeNumber" si au optiunea (in cazul in care este activat stocul) de a folosi parametrul "useStock" care are valoarea implicita 1

Emitere facturi

https://www.oblio.eu/api/docs/invoice - POST

Emiterea facturilor se face identic cu emiterea proformelor cu diferenta ca facturile mai au si urmatorii parametrii:

Parametri document
Parametru Explicatie
deliveryDate Data livrarii in format AAAA-LL-ZZ
collectDate Data incasarii in format AAAA-LL-ZZ
referenceDocument Document de referinta in cazul generarii de facturi pe baza de proforma sau de aviz. Vezi "Parametri document de referinta"
collect Incasare document. Vezi "Parametri incasare document"
useStock Descarcare pe gestiune (in cazul in care este activat stocul). Poate fi 0 sau 1

Parametri document de referinta
Parametru Explicatie
type * Tipul documentului de referinta (Factura, Proforma sau Aviz)
seriesName * Numele seriei documentului de referinta
number * Numarul seriei documentului de referinta
refund Sterge incasarea asociata cu factura stornata pentru "type" = "Factura". Poate fi 0 sau 1

Parametri incasare document
Parametru Explicatie
type * Tipul de document cu care se face incasarea. Poate fi "Chitanta", "Bon fiscal", "Alta incasare numerar", "Ordin de plata", "Mandat postal", "Card", "CEC", "Bilet ordin", "Alta incasare banca"
seriesName Numele seriei chitantei. Trebuie definita in cazul in care incasarea se face prin chitanta
documentNumber Numarul documentului de incasare. Trebuie definit in cazul in care incasarea nu se face prin chitanta
value Valoarea incasata, valoarea implicita este totalul facturii care urmeaza sa fie incasata
issueDate Data emiterii in format AAAA-LL-ZZ, valoare implicita este ziua curenta (valabil pentru incasare factura)
mentions Mentiuni

Exemplu de fisier JSON pentru factura simpla
{
"cif": "RO37311090",
"client": {
"cif": "RO37311090",
"name": "OBLIO SOFTWARE SRL",
"rc": "J13/887/2017",
"code": "oblio",
"address": "",
"state": "Constanta",
"city": "Constanta",
"country": "",
"iban": "",
"bank": "",
"email": "",
"phone": "",
"contact": "",
"vatPayer": true
},
"issueDate": "2018-10-15",
"dueDate": "2018-10-30",
"deliveryDate":"2018-10-16",
"collectDate":"2018-10-29",
"seriesName": "FCT",
"language": "RO",
"precision": 2,
"currency": "RON",
"products": [
{
"name": "Test",
"code": "test",
"description": "Descriere de test",
"price": 200,
"measuringUnit": "buc",
"vatName": "Normala",
"vatPercentage": 19,
"vatIncluded": 0,
"quantity": 2,
"productType": "Serviciu",
"management": "Magazin"
},
{
"name": "Discount 10% Test",
"discount": 10,
"discountType": "procentual"
}
],
"issuerName": "Ion Popescu",
"issuerId": 1234567890123,
"noticeNumber": "AVZ 0041",
"internalNote": "Factura emisa din API",
"deputyName": "George Popescu",
"deputyIdentityCard": "ID 1234",
"deputyAuto": "CT 12345",
"selesAgent": "Marian Popescu",
"mentions": "Factura de test emisa din API",
"workStation": "Sediu"
}
Exemplu de creare factura
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -d @invoice.json -X POST https://www.oblio.eu/api/docs/invoice
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": {
"seriesName": "FCT",
"number": "0053",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261751&it=bde87369631a5340057280037419f7e7"
}
}

Exemplu de fisier JSON pentru factura pe baza de proforma
{
"cif": "RO37311090",
"seriesName": "FCT",
"referenceDocument": {
"type": "Proforma",
"seriesName": "PR",
"number": 8
}
}

Exemplu de fisier JSON pentru stornare totala de factura
{
"cif": "RO37311090",
"seriesName": "FCT",
"referenceDocument": {
"type": "Factura",
"refund": 1,
"seriesName": "FCT",
"number": 568
}
}

Exemplu de fisier JSON pentru factura cu incasare
{
"cif": "RO37311090",
"client": {
"cif": "RO37311090",
"name": "OBLIO SOFTWARE SRL",
"rc": "J13/887/2017",
"code": "oblio",
"address": "",
"state": "Constanta",
"city": "Constanta",
"country": "",
"iban": "",
"bank": "",
"email": "",
"phone": "",
"contact": "",
"vatPayer": true
},
"issueDate": "2018-10-15",
"dueDate": "2018-10-30",
"seriesName": "FCT",
"language": "RO",
"precision": 2,
"currency": "RON",
"collect": {
"type": "Ordin de plata",
"documentNumber": "OP 7001"
},
"products": [
{
"name": "Test",
"code": "test",
"description": "Descriere de test",
"price": 200,
"measuringUnit": "buc",
"vatName": "Normala",
"vatPercentage": 19,
"vatIncluded": 0,
"quantity": 2,
"productType": "Serviciu",
"management": "Magazin"
},
{
"name": "Discount 10% Test",
"discount": 10,
"discountType": "procentual"
}
],
"workStation": "Sediu"
}

Incasare factura

Incasare factura

https://www.oblio.eu/api/docs/invoice/collect - PUT

Incasare facturilor se face cu urmatorii parametrii:

Parametri incasare factura
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Numele seriei documentului
number * Numarul seriei documentului
collect * Incasare document. Vezi "Parametri incasare document"

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/x-www-form-urlencoded" -d "cif=RO37311090&seriesName=FCT&number=55&collect[type]=Ordin+de+plata&collect[documentNumber]=OP+7001" -X PUT https://www.oblio.eu/api/docs/invoice/collect
Raspuns
{
"status": 200,
"statusMessage": "",
"data": {
"documentType": "Factura",
"seriesName": "FCT",
"number": "0055",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261753&it=8e4beb8abe58552dd702874addd1d518",
"collects": [
{
"issueDate": "2018-10-15",
"type": "Ordin de plata",
"number": "OP 7001",
"value": 428.4
}
]
}
}

Vizualizare documente

Vizualizare factura

https://www.oblio.eu/api/docs/invoice?cif={cif}&seriesName={seriesName}&number={number} - GET
Parametri vizualizare document
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Numele seriei documentului
number * Numarul seriei documentului

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/docs/invoice?cif=RO37311090&seriesName=FCT&number=55"
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": {
"documentType": "Factura",
"seriesName": "FCT",
"number": "0055",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261753&it=8e4beb8abe58552dd702874addd1d518",
"collects": [
{
"issueDate": "2018-10-15",
"type": "Ordin de plata",
"number": "OP 7001",
"value": 428.4
}
]
}
}

Vizualizare proforma

https://www.oblio.eu/api/docs/proforma?cif={cif}&seriesName={seriesName}&number={number} - GET

Parametrii sunt aceiasi ca la vizualizare factura

Vizualizare aviz

https://www.oblio.eu/api/docs/notice?cif={cif}&seriesName={seriesName}&number={number} - GET

Parametrii sunt aceiasi ca la vizualizare factura

Anulare documente

Anulare factura

https://www.oblio.eu/api/docs/invoice/cancel - PUT

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/x-www-form-urlencoded" -d "cif=RO37311090&seriesName=FCT&number=55" -X PUT https://www.oblio.eu/api/docs/invoice/cancel
Raspuns
{
"status": 200,
"statusMessage": "Documentul a fost anulat.",
"data": {
"documentType": "Factura",
"seriesName": "FCT",
"number": "0055",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261753&it=8e4beb8abe58552dd702874addd1d518"
}
}

Parametri anulare document
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Numele seriei documentului
number * Numarul seriei documentului

Anulare proforma

https://www.oblio.eu/api/docs/proforma/cancel - PUT

Parametrii sunt aceiasi ca la anulare factura

Anulare aviz

https://www.oblio.eu/api/docs/notice/cancel - PUT

Parametrii sunt aceiasi ca la anulare factura

Restaurare documente

Restaurare factura

https://www.oblio.eu/api/docs/invoice/restore - PUT

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/x-www-form-urlencoded" -d "cif=RO37311090&seriesName=FCT&number=55" -X PUT https://www.oblio.eu/api/docs/invoice/restore
Raspuns
{
"status": 200,
"statusMessage": "Documentul a fost restaurat.",
"data": {
"documentType": "Factura",
"seriesName": "FCT",
"number": "0055",
"link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261753&it=8e4beb8abe58552dd702874addd1d518"
}
}

Parametri restaurare document
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Numele seriei documentului
number * Numarul seriei documentului

Restaurare proforma

https://www.oblio.eu/api/docs/proforma/restore - PUT

Parametrii sunt aceiasi ca la restaurare factura

Restaurare aviz

https://www.oblio.eu/api/docs/notice/restore - PUT

Parametrii sunt aceiasi ca la restaurare factura

Stergere documente

Stergere factura

https://www.oblio.eu/api/docs/invoice - DELETE

Functia de stergere se poate folosi doar pentru ultimul document din serie.

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/x-www-form-urlencoded" -d "cif=RO37311090&seriesName=FCT&number=55" -X DELETE https://www.oblio.eu/api/docs/invoice
Raspuns
{
"status": 200,
"statusMessage": "Documentul a fost sters.",
"data": {
"documentType": "Factura",
"seriesName": "FCT",
"number": "0055"
}
}

Parametri stergere document
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Numele seriei documentului
number * Numarul seriei documentului

Stergere proforma

https://www.oblio.eu/api/docs/proforma - DELETE

Parametrii sunt aceiasi ca la stergere factura

Stergere aviz

https://www.oblio.eu/api/docs/notice - DELETE

Parametrii sunt aceiasi ca la stergere factura

Raport documente

Listare facturi

https://www.oblio.eu/api/docs/invoice/list - GET

Functia de listare a facturilor emise in Oblio.

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/docs/invoice/list?cif=RO37311090&seriesName=FCT&number=55&issuedAfter=2023-08-01&issuedBefore=2023-08-31&client[cif]=1111"
Raspuns
{ "status": 200, "statusMessage": "Success", "data": [ { "id": "22441901", "draft": "0", "canceled": "0", "seriesName": "FCT", "number": "0126", "issueDate": "2023-05-30", "dueDate": "2023-05-30", "precision": "2", "currency": "RON", "exchangeRate": "0.000000", "total": "51.2700", "issuerName": "", "issuerId": "", "noticeNumber": "", "deputyName": "", "deputyIdentityCard": "", "deputyAuto": "", "mentions": "", "useStock": "0", "type": "Factura", "link": "https://www.oblio.eu/utils/show_file/?ic=306625&id=22441901&it=d80968a8ada558491eab06a6caf6e40c", "client": { "clientId": "2960257", "cif": "1111", "name": "CONCEPT S.A.", "rc": "J40/1090/1991", "code": "", "address": "SECTOR 2, B-DUL PACHE PROTOPOPESCU, NR.109, ET.3", "state": "BUCUREŞTI", "city": "MUNICIPIUL BUCUREŞTI", "country": "", "iban": "", "bank": "", "contact": "", "phone": "", "email": "", "vatPayer": "0" } } ] }

Parametri listare documente
Parametru Explicatie
cif * CIF-ul firmei
seriesName Filtru dupa Numele seriei
number Filtru dupa Numarul documentului
id Filtru dupa id
draft Filtru dupa Document draft. Poate lua valorile -1 - este ignorat, 0 - nu sunt draft, 1 - sunt draft
client Filtru dupa Client. Contine un array/map cu "cif", "email", "phone" sau "code"
canceled Filtru dupa Document anulat. Poate lua valorile -1 - este ignorat, 0 - nu sunt anulate, 1 - sunt anulate
issuedAfter Filtru dupa Data de inceput in format AAAA-LL-ZZ
issuedBefore Filtru dupa Data de sfarsit in format AAAA-LL-ZZ
withProducts Include si produsele din factura in rezultat
withEinvoiceStatus Include status-ul facturilor din SPV
orderBy Ordonare dupa: id, issueDate, number
orderDir Ordonare ASC/DESC
limitPerPage Rezultate pe pagina. Maxim 100
offset Vor aparea initial maxim 100 de rezultate, este de preferat sa fie multiplu de 100 (0, 100, 100 etc.), valoarea implicita este 0

SPV

Trimite factura in SPV

https://www.oblio.eu/api/docs/einvoice - POST

Functia de Trimite factura in SPV pentru facturile emise in Oblio.

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X POST "https://www.oblio.eu/api/docs/einvoice" -d "cif=RO37311090&seriesName=FCT&number=55"
Raspuns
{ "status": 200, "statusMessage": "Success", "data": { "text": "e-Factura trimisa cu succes in SPV.", "sent": false, "code": 0 } }

Parametri pentru Trimite factura in SPV
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Filtru dupa Numele seriei
number * Filtru dupa Numarul documentului

Descarca arhiva SPV

https://www.oblio.eu/api/docs/einvoice - GET

Functia de descarcare arhiva SPV pentru facturile emise in Oblio.

Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/docs/einvoice?cif=RO37311090&seriesName=FCT&number=55"

Parametri descarcare arhiva SPV
Parametru Explicatie
cif * CIF-ul firmei
seriesName * Filtru dupa Numele seriei
number * Filtru dupa Numarul documentului

Webhooks

Permite aplicatiei dvs. sa fie notificata atunci cand se produce o actiune in Oblio.

Acestea functioneaza pe modelul pub/sub in care aplicatia externa se aboneaza la un topic si primeste update-uri atunci cand este cazul.

Creare webhook

https://www.oblio.eu/api/webhooks - POST
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/json" -d "{\"cif\": 37311090, \"topic\": \"stock\", \"endpoint\": \"https://exemplu.com/update-stock/\"}" -X POST https://www.oblio.eu/api/webhooks
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": {
"cif": "37311090",
"topic": "stock",
"endpoint": "https://exemplu.com/update-stock/",
"id": "123"
}
}
Parametru Explicatie
cif * CIF-ul firmei
topic * Evenimentul la care doriti sa va abonati. Poate fi: "stock", "Invoice/SaveDraft", "Proforma/SaveDraft", "Notice/SaveDraft", "TaxReceipt/SaveDraft", "Invoice/Cancel", "Proforma/Cancel", "Notice/Cancel", "TaxReceipt/Cancel", "Collect/Inserted"
endpoint * Adresa la care se trimit notificari. Aceasta trebuie sa raspunda cu status code 200 si sa afiseze valoarea encodata base64 a header-ului "X-Oblio-Request-Id" trimis in request

Listare webhooks

https://www.oblio.eu/api/webhooks - GET
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/json" -X GET https://www.oblio.eu/api/webhooks
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": [
{
"cif": "37311090",
"topic": "stock",
"endpoint": "https://exemplu.com/update-stock/",
"id": "123"
}
]
}

Stergere webhook

https://www.oblio.eu/api/webhooks/{id} - DELETE
Exemplu
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/json" -X DELETE https://www.oblio.eu/api/webhooks/123
Raspuns
{
"status": 200,
"statusMessage": "Success",
"data": {
"cif": "37311090",
"topic": "stock",
"endpoint": "https://exemplu.com/update-stock/",
"id": "123"
}
}

Ce spun clientii

Oblio este programul de facturare si gestiune iubit de utilizatorii sai.

Il am de cativa ani. Este minunat, foarte usor de folosit.
Recomand cu drag !

IANO MET S.R.L.

Multumim pentru colaborare.
Il voi recomanda prietenilor.
Sunteti profesionisti!

ABC - 456 COM SRL

Este foarte accesibil, ușor de lucrat pe el.
L-as recomanda tuturor.
Mulțumesc

GÂNJA LUMINIŢA GABRIELA PERSOANĂ FIZICĂ AUTORIZATĂ

O aplicație foarte buna! Ma ajuta enorm! Ma pot baza pe sistemul acesta oricând, simplu și eficient!

KAIROS IMOB DEVELOPMENT S.R.L.

Oblio este un program complex și ușor de folosit. Sunt mândră că am ales acest program de la bun început.

SEPSI PROTEKT S.A.

Foarte mulțumită!!!
Categoric voi recomanda!

CATANA SORINA-ILEANA PERSOANA FIZICA AUTORIZATA

Este extraordinar, cel puțin pentru mine este minunat pentru ca sunt începător și ma pricep mai puțin la tehnologie și mai puțin la contabilitate. Va mulțumesc ca exista o echipa ca Oblio !

VILALEX SERV CC S.R.L.

Este usor de lucrat cu el., accesibil.Cu siguranta o sa-l recomand.
Multumesc!

LENKIEWICZ C. LUCIEA-GEORGETA - CABINET MEDICAL INDIVIDUAL

Sunt foarte multumit de Oblio si am recomandat tuturor cunostintelor!

PRODATA PLUS SISTEM SRL

E foarte ușor și util va mulțumesc mult.

BUTOI I. IOANA PERSOANĂ FIZICĂ AUTORIZATĂ