Oblio API

https://www.oblio.eu/api
Admin
The Oblio API provides developers with programmatic access to Oblio's accounting functionalities,...
Tokens:19,321
Snippets:109
Trust Score:8.5
Update:5 months ago
Show doc for...
Tokens:
Raw
### Example Product Response

Source: https://www.oblio.eu/api

Example JSON response structure for the product nomenclature endpoint, detailing product types, prices, and stock information.

```json
{
 "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
            }
        ]
    }
]
}
```

--------------------------------

### Example Management Response

Source: https://www.oblio.eu/api

Example JSON response for the management nomenclature endpoint, detailing management names, workstations, and types.

```json
{
 "status": 200,
 "statusMessage": "Success",
 "data": [
        {
 "management": "Magazin",
 "workStation": "Sediu",
 "managementType": "Cantitativ Valorica"
        },
        {
 "management": "Mobila",
 "workStation": "Depozit",
 "managementType": "Cantitativ Valorica"
        }
    ]
}
```

--------------------------------

### Example Languages Response

Source: https://www.oblio.eu/api

Example JSON response for the languages nomenclature endpoint, listing language codes and names.

```json
{
 "status": 200,
 "statusMessage": "Success",
 "data": [
        {
 "code": "EN",
 "name": "Engleza"
        },
        {
 "code": "FR",
 "name": "Franceza"
        }
    ]
}
```

--------------------------------

### Example Document Series Response

Source: https://www.oblio.eu/api

Example JSON response for the document series nomenclature endpoint, showing series type, name, and numbering details.

```json
{
 "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
        }
    ]
}
```

--------------------------------

### Example Proforma JSON Structure

Source: https://www.oblio.eu/api

This JSON structure represents a proforma document. It includes client details, issue and due dates, currency, and product information. Ensure all required fields are populated.

```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"
}
```

--------------------------------

### List Webhooks - GET

Source: https://www.oblio.eu/api

Retrieve a list of all registered webhooks for your account. This endpoint returns an array of webhook objects, each containing details like CIF, topic, endpoint, and ID.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -H "Content-Type: application/json" -X GET https://www.oblio.eu/api/webhooks
```

```json
{
 "status": 200,
 "statusMessage": "Success",
 "data": [
        {
 "cif": "37311090",
 "topic": "stock",
 "endpoint": "https://exemplu.com/update-stock/",
 "id": "123"
        }
    ]
}
```

--------------------------------

### Get Product Nomenclature

Source: https://www.oblio.eu/api

Retrieves a list of products for a specific company. For services, stock information is not included. Supports filtering by name, code, and management.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/products?cif=RO37311090"
```

--------------------------------

### List Documents API Response

Source: https://www.oblio.eu/api

Example response structure when listing documents via the API. It includes details about invoices, issuers, and clients.

```json
{
    "status": 200,
    "statusMessage": "Success",
    "data": [
        {
            "id": "105595937",
            "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",
            "indexUpload": null,
            "idDownload": null,
            "type": "Factura",
            "link": "https://www.oblio.eu/utils/show_file/?ic=306625&id=105595937&it=e54c982243d86b513c3942f2f0a4502c&preload=1",
            "einvoice": "https://www.oblio.eu/utils/show_file/?ic=306625&id=105595937&it=e54c982243d86b513c3942f2f0a4502c&einvoice=1&api=1",
            "einvoiceStatus": {
                "text": "Neconfigurat",
                "sent": false,
                "code": -1
            },
            "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"
             }
        }
    ]
}
```

--------------------------------

### Send Invoice to SPV API Request

Source: https://www.oblio.eu/api

Example cURL command to send an invoice to the SPV. Requires authorization and specific invoice details.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X POST "https://www.oblio.eu/api/docs/einvoice" -d "cif=RO37311090&seriesName=FCT&number=55"
```

--------------------------------

### Download SPV Archive API Request

Source: https://www.oblio.eu/api

Example cURL command to download an SPV archive. Requires authorization and invoice identification parameters.

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

--------------------------------

### Get Document Series Nomenclature

Source: https://www.oblio.eu/api

Retrieves a list of document series for a specific company. Requires the company's CIF as a parameter.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/series?cif=RO37311090"
```

--------------------------------

### Send Invoice to SPV API Response

Source: https://www.oblio.eu/api

Example response after attempting to send an invoice to the SPV. Indicates success or failure status.

```json
{
    "status": 200,
    "statusMessage": "Success",
    "data": {
        "text": "e-Factura trimisa cu succes in SPV.",
        "sent": true,
        "code": 0
    }
}
```

--------------------------------

### Get Clients Nomenclator with cURL

Source: https://www.oblio.eu/api

Retrieve a list of clients for a specific company using this cURL command. You can filter by CIF, name, or use offset for pagination. Replace '67d6f8817c28d698bdae35728c7a30b02a75bd4d' with your access token.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/clients?cif=RO37311090"
```

--------------------------------

### Get Languages Nomenclature

Source: https://www.oblio.eu/api

Retrieves a list of foreign languages available for a specific company. The company's CIF is a required parameter.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/languages?cif=RO37311090"
```

--------------------------------

### Get Management Nomenclature

Source: https://www.oblio.eu/api

Retrieves a list of management types for a specific company. This endpoint functions only if stock management is activated. Requires the company's CIF.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/management?cif=RO37311090"
```

--------------------------------

### Get VAT Rates Nomenclator with cURL

Source: https://www.oblio.eu/api

Fetch the list of VAT rates for a specific company using this cURL command. Provide the company's CIF (tax identification number) and your access token.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/vat_rates?cif=RO37311090"
```

--------------------------------

### Get Companies Nomenclator with cURL

Source: https://www.oblio.eu/api

Retrieve a list of companies associated with your Oblio account using this cURL command. Replace '67d6f8817c28d698bdae35728c7a30b02a75bd4d' with your obtained access token.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET https://www.oblio.eu/api/nomenclature/companies
```

--------------------------------

### Create Webhook - POST

Source: https://www.oblio.eu/api

Use this endpoint to register a new webhook. Provide the company's CIF, the event topic, and the notification endpoint URL. The endpoint must respond with a 200 status code and the base64 encoded value of the 'X-Oblio-Request-Id' header.

```bash
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
```

```json
{
 "status": 200,
 "statusMessage": "Success",
 "data": {
 "cif": "37311090",
 "topic": "stock",
 "endpoint": "https://exemplu.com/update-stock/",
 "id": "123"
 }
}
```

--------------------------------

### View Notice

Source: https://www.oblio.eu/api

Retrieves a notice document. The parameters are the same as for viewing an invoice.

```APIDOC
## GET /api/docs/notice?cif={cif}&seriesName={seriesName}&number={number}

### Description
Retrieves a notice document.

### Method
GET

### Endpoint
/api/docs/notice

### Parameters
#### Query Parameters
- **cif** (string) - Required - CIF of the company.
- **seriesName** (string) - Required - Name of the document series.
- **number** (string) - Required - Number of the document series.
```

--------------------------------

### Generate Access Token with cURL

Source: https://www.oblio.eu/api

Use this cURL command to obtain an access token for authenticating with the Oblio REST API. Ensure you replace 'nume@exemplu.com' with your Oblio email and '1edd9e4f6...' with your actual client secret.

```bash
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
```

--------------------------------

### Create Notice

Source: https://www.oblio.eu/api

This endpoint is used to issue notices. The process is identical to issuing proformas, with the exception that notices do not have the 'noticeNumber' parameter and can optionally use the 'useStock' parameter.

```APIDOC
## Create Notice

### Description
Issues notices. Functionality is identical to creating proformas, with the omission of the 'noticeNumber' parameter and the optional 'useStock' parameter (defaults to 1 if stock is enabled).

### Method
POST

### Endpoint
https://www.oblio.eu/api/docs/notice

### Parameters
Refer to the 'Create Proforma' endpoint for common parameters. The following are specific to notices:
- **useStock** (integer) - Optional - Use stock management. Defaults to 1 if enabled.
```

--------------------------------

### List Webhooks

Source: https://www.oblio.eu/api

Retrieves a list of all currently configured webhooks for the authenticated user.

```APIDOC
## GET /api/webhooks

### Description
Retrieves a list of all configured webhooks.

### Method
GET

### Endpoint
https://www.oblio.eu/api/webhooks

### Response
#### Success Response (200)
- **data** (array) - A list of webhook objects.
  - Each object contains:
    - **cif** (string) - The company's CIF.
    - **topic** (string) - The subscribed event topic.
    - **endpoint** (string) - The notification endpoint URL.
    - **id** (string) - The unique identifier for the webhook.

### Response Example
```json
{
  "status": 200,
  "statusMessage": "Success",
  "data": [
    {
      "cif": "37311090",
      "topic": "stock",
      "endpoint": "https://exemplu.com/update-stock/",
      "id": "123"
    }
  ]
}
```
```

--------------------------------

### Create Invoice

Source: https://www.oblio.eu/api

This endpoint allows for the creation of invoices. It is similar to creating proformas but includes additional parameters for delivery date, collection date, reference documents, payment collection, and stock usage.

```APIDOC
## Create Invoice

### Description
Issues invoices. Similar to proformas, with additional parameters for delivery and collection dates, reference documents, payment collection, and stock management.

### Method
POST

### Endpoint
https://www.oblio.eu/api/docs/invoice

### Parameters
Refer to the 'Create Proforma' endpoint for common parameters. The following are specific to invoices:

#### Document Parameters
- **deliveryDate** (string) - Date of delivery in YYYY-MM-DD format.
- **collectDate** (string) - Date of collection in YYYY-MM-DD format.
- **referenceDocument** (object) - Reference document details for generating invoices based on proformas or notices.
  - **type** (string) - Required - Type of reference document (Factura, Proforma, or Aviz).
  - **seriesName** (string) - Required - Series name of the reference document.
  - **number** (string) - Required - Number of the reference document.
  - **refund** (integer) - Optional - Set to 1 to remove the associated collection for a credited invoice.
- **collect** (object) - Payment collection details.
  - **type** (string) - Required - Type of collection document (e.g., "Chitanta", "Bon fiscal", "Ordin de plata").
  - **seriesName** (string) - Required if type is "Chitanta" - Series name of the receipt.
  - **documentNumber** (string) - Required if type is not "Chitanta" - Number of the collection document.
  - **value** (number) - Optional - Collected amount, defaults to the invoice total.
  - **issueDate** (string) - Optional - Date of issue in YYYY-MM-DD format, defaults to the current day.
  - **mentions** (string) - Optional - Notes.
- **useStock** (integer) - Optional - Download to inventory if stock is enabled. Can be 0 or 1.
- **spvExtern** (boolean) - Optional - If true and "Send e-Invoice automatically to SPV" is enabled in Settings, the invoice is sent automatically to SPV. Otherwise, manual sending is required.
```

--------------------------------

### Create Proforma API Request

Source: https://www.oblio.eu/api

This cURL command demonstrates how to create a proforma document using the Oblio API. It requires an authorization token and sends the proforma data in JSON format.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -d @proforma.json -X POST https://www.oblio.eu/api/docs/proforma
```

--------------------------------

### Create Simple Invoice JSON

Source: https://www.oblio.eu/api

Use this JSON structure to create a simple invoice. Ensure all required fields are populated.

```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",
  "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"
}
```

--------------------------------

### Create Invoice

Source: https://www.oblio.eu/api

Allows users to create a new invoice by sending invoice details in JSON format. The endpoint supports various invoice types, including simple invoices, proforma invoices, and total credit notes.

```APIDOC
## POST /invoice

### Description
Creates a new invoice.

### Method
POST

### Endpoint
https://www.oblio.eu/api/docs/invoice

### Request Body
- **cif** (string) - Required - The company's CIF.
- **client** (object) - Optional - Client details.
- **issueDate** (string) - Required - The date the invoice is issued.
- **dueDate** (string) - Optional - The due date for the invoice.
- **deliveryDate** (string) - Optional - The delivery date of the goods or services.
- **collectDate** (string) - Optional - The date of collection.
- **seriesName** (string) - Required - The name of the invoice series.
- **language** (string) - Optional - The language of the invoice (e.g., 'RO').
- **precision** (integer) - Optional - The number of decimal places for currency.
- **currency** (string) - Optional - The currency of the invoice (e.g., 'RON').
- **products** (array) - Required - An array of product objects.
- **issuerName** (string) - Optional - The name of the issuer.
- **issuerId** (integer) - Optional - The ID of the issuer.
- **noticeNumber** (string) - Optional - The notice number.
- **internalNote** (string) - Optional - An internal note for the invoice.
- **deputyName** (string) - Optional - The name of the deputy.
- **deputyIdentityCard** (string) - Optional - The deputy's identity card details.
- **deputyAuto** (string) - Optional - The deputy's vehicle registration.
- **selesAgent** (string) - Optional - The sales agent's name.
- **mentions** (string) - Optional - Additional mentions for the invoice.
- **workStation** (string) - Optional - The workstation where the invoice was issued.
- **referenceDocument** (object) - Optional - Used for creating invoices based on proforma or for credit notes.
  - **type** (string) - Required - Type of reference document (e.g., 'Proforma', 'Factura').
  - **refund** (integer) - Optional - Indicates a full refund (1 for full refund).
  - **seriesName** (string) - Required - Series name of the reference document.
  - **number** (integer) - Required - Number of the reference document.
- **collect** (object) - Optional - Details for immediate collection.
  - **type** (string) - Required - Type of collection (e.g., 'Ordin de plata').
  - **documentNumber** (string) - Required - The document number for the collection.

### Request Example
```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",
  "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"
}
```

### Response
#### Success Response (200)
- **status** (integer) - The status code of the response.
- **statusMessage** (string) - A message indicating the success of the operation.
- **data** (object) - Contains details about the created invoice.
  - **seriesName** (string) - The series name of the created invoice.
  - **number** (string) - The number of the created invoice.
  - **link** (string) - A link to view the created invoice.

#### Response Example
```json
{
  "status": 200,
  "statusMessage": "Success",
  "data": {
    "seriesName": "FCT",
    "number": "0053",
    "link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261751&it=bde87369631a5340057280037419f7e7"
  }
}
```
```

--------------------------------

### Create Webhook

Source: https://www.oblio.eu/api

Allows your application to be notified when an action occurs in Oblio. This functions on a pub/sub model where external applications subscribe to a topic and receive updates.

```APIDOC
## POST /api/webhooks

### Description
Creates a webhook to receive notifications about actions in Oblio.

### Method
POST

### Endpoint
https://www.oblio.eu/api/webhooks
```

--------------------------------

### Create Webhook

Source: https://www.oblio.eu/api

Allows users to subscribe to events and specify an endpoint for receiving notifications. The endpoint must respond with a 200 status code and the base64 encoded value of the 'X-Oblio-Request-Id' header.

```APIDOC
## POST /api/webhooks

### Description
Subscribes to events and sets a notification endpoint.

### Method
POST

### Endpoint
https://www.oblio.eu/api/webhooks

### Parameters
#### Request Body
- **cif** (integer) - Required - The company's CIF.
- **topic** (string) - Required - The event to subscribe to. Possible values: "stock", "Invoice/SaveDraft", "Proforma/SaveDraft", "Notice/SaveDraft", "TaxReceipt/SaveDraft", "Invoice/Update", "Proforma/Update", "Notice/Update", "Invoice/Cancel", "Proforma/Cancel", "Notice/Cancel", "TaxReceipt/Cancel", "Collect/Inserted".
- **endpoint** (string) - Required - The URL to send notifications to. This URL must respond with a 200 status code and display the base64 encoded value of the 'X-Oblio-Request-Id' header sent in the request.

### Request Example
```json
{
  "cif": 37311090,
  "topic": "stock",
  "endpoint": "https://exemplu.com/update-stock/"
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains the details of the created webhook.
  - **cif** (string) - The company's CIF.
  - **topic** (string) - The subscribed event topic.
  - **endpoint** (string) - The notification endpoint URL.
  - **id** (string) - The unique identifier for the webhook.
```

--------------------------------

### Create Invoice API Request

Source: https://www.oblio.eu/api

Use this cURL command to send an invoice creation request to the OBLIO API. Ensure you replace the placeholder token with your actual API key.

```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -d @invoice.json -X POST https://www.oblio.eu/api/docs/invoice
```

--------------------------------

### Create Proforma

Source: https://www.oblio.eu/api

This endpoint allows for the creation of proforma documents. It requires a JSON payload containing proforma details and an authorization token.

```APIDOC
## Create Proforma

### Description
Allows for the creation of proforma documents.

### Method
POST

### Endpoint
https://www.oblio.eu/api/docs/proforma

### Request Body
- **cif** (string) - Required - CIF of the client.
- **client** (object) - Required - Client details.
  - **cif** (string) - Required.
  - **name** (string) - Required.
  - **rc** (string) - Required.
  - **code** (string) - Required.
  - **address** (string) - Optional.
  - **state** (string) - Optional.
  - **city** (string) - Optional.
  - **country** (string) - Optional.
  - **iban** (string) - Optional.
  - **bank** (string) - Optional.
  - **email** (string) - Optional.
  - **phone** (string) - Optional.
  - **contact** (string) - Optional.
  - **vatPayer** (boolean) - Required.
- **issueDate** (string) - Required - Date in YYYY-MM-DD format.
- **dueDate** (string) - Required - Date in YYYY-MM-DD format.
- **seriesName** (string) - Required.
- **language** (string) - Required.
- **precision** (integer) - Required.
- **currency** (string) - Required.
- **products** (array) - Required - Array of product objects.
  - **name** (string) - Required.
  - **code** (string) - Optional.
  - **description** (string) - Optional.
  - **price** (number) - Required.
  - **measuringUnit** (string) - Optional.
  - **vatName** (string) - Optional.
  - **vatPercentage** (number) - Required.
  - **vatIncluded** (number) - Required.
  - **quantity** (number) - Required.
  - **productType** (string) - Optional.
  - **management** (string) - Optional.
  - **discount** (number) - Optional.
  - **discountType** (string) - Optional.
- **issuerName** (string) - Required.
- **issuerId** (integer) - Required.
- **noticeNumber** (string) - Optional.
- **internalNote** (string) - Optional.
- **deputyName** (string) - Optional.
- **deputyIdentityCard** (string) - Optional.
- **deputyAuto** (string) - Optional.
- **selesAgent** (string) - Optional.
- **mentions** (string) - Optional.
- **workStation** (string) - Optional.

### Request Example
```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"
}
```

### Response
#### Success Response (200)
- **status** (integer) - HTTP status code.
- **statusMessage** (string) - Success message.
- **data** (object) - Response data.
  - **seriesName** (string) - Name of the series.
  - **number** (string) - Document number.
  - **link** (string) - Link to the generated document.

#### Response Example
```json
{
  "status": 200,
  "statusMessage": "Success",
  "data": {
    "seriesName": "PR",
    "number": "0008",
    "link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261747&it=b8590b71a702ab3788f0dda5d5c77d23"
  }
}
```
```

--------------------------------

### Invoice Creation Response

Source: https://www.oblio.eu/api

This is a sample successful response after creating an invoice via the API. It includes the invoice series name, number, and a link to view the generated document.

```json
{
  "status": 200,
  "statusMessage": "Success",
  "data": {
    "seriesName": "FCT",
    "number": "0053",
    "link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261751&it=bde87369631a5340057280037419f7e7"
  }
}
```

--------------------------------

### Emitere proforma

Source: https://www.oblio.eu/api

Issuing proforma documents is done using the POST method by sending raw data in JSON format.

```APIDOC
## POST /docs/proforma

### Description
Issuing proforma documents is done using the POST method by sending raw data in JSON format.

### Method
POST

### Endpoint
https://www.oblio.eu/api/docs/proforma

### Parameters
#### Request Body
- **Parameters for issuing proforma documents** (object) - Required - Details about the proforma document to be issued. (Specific fields not detailed in the source text)

### Request Example
(Request body details not provided in the source text)

### Response
(Response details not provided in the source text)
```

--------------------------------

### Collect Invoice API Request

Source: https://www.oblio.eu/api

This cURL command demonstrates how to record a payment for an invoice using the OBLIO API. It requires the invoice details and collection information.

```bash
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
```

--------------------------------

### Create Total Invoice Reversal JSON

Source: https://www.oblio.eu/api

Use this JSON to create a total reversal (credit note) for an existing invoice. Provide the original invoice's series name and number.

```json
{
  "cif": "RO37311090",
  "seriesName": "FCT",
  "referenceDocument": {
    "type": "Factura",
    "refund": 1,
    "seriesName": "FCT",
    "number": 568
  }
}
```

--------------------------------

### View Invoice Details

Source: https://www.oblio.eu/api

Retrieve detailed information about a specific invoice. Parameters are similar to viewing a proforma.

```json
{
 "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
            }
        ]
    }
}
```

--------------------------------

### Nomenclator produse

Source: https://www.oblio.eu/api

Returns the list of products for a specific company. For services, the stock management is not considered and the 'stock' field will not appear.

```APIDOC
## GET /nomenclature/products

### Description
Returns the list of products for a specific company. For services, the stock management is not considered and the 'stock' field will not appear.

### Method
GET

### Endpoint
https://www.oblio.eu/api/nomenclature/products

### Parameters
#### Query Parameters
- **cif** (string) - Required - CIF of the company
- **name** (string) - Optional - Name of the product to search for
- **code** (string) - Optional - Code of the product to search for
- **management** (string) - Optional - The management where the search is performed (Using this parameter will list products as services)
- **workStation** (string) - Optional - The workstation of the management where the search is performed
- **offset** (integer) - Optional - Maximum of 250 results will appear initially, it is preferable to be a multiple of 250 (0, 250, 500 etc.), the default value is 0

### Request Example
```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/products?cif=RO37311090"
```

### Response
#### Success Response (200)
- **data** (array) - List of products
  - **name** (string) - Product name
  - **code** (string) - Product code
  - **description** (string) - Product description
  - **measuringUnit** (string) - Measuring unit
  - **productType** (string) - Type of product (e.g., 'Serviciu', 'Marfa')
  - **price** (string) - Product price
  - **currency** (string) - Product currency
  - **vatName** (string) - VAT name
  - **vatPercentage** (integer) - VAT percentage
  - **vatIncluded** (boolean) - Whether VAT is included
  - **stock** (array) - Stock information (only for 'Marfa' type products)
    - **workStation** (string) - Workstation name
    - **management** (string) - Management name
    - **quantity** (integer) - Stock quantity
    - **price** (string) - Stock price
    - **currency** (string) - Stock currency
    - **vatName** (string) - VAT name
    - **vatPercentage** (integer) - VAT percentage
    - **vatIncluded** (boolean) - Whether VAT is included

### Response Example
```json
{
 "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
                }
            ]
        }
    ]
}
```
```

--------------------------------

### Proforma Creation API Response

Source: https://www.oblio.eu/api

This is a sample successful response from the Oblio API after creating a proforma document. It includes the status, status message, and data about the created document, such as its series name, number, and a link.

```json
{
 "status": 200,
 "statusMessage": "Success",
 "data": {
 "seriesName": "PR",
 "number": "0008",
 "link": "https://www.oblio.eu/utils/show_file/?ic=91467&id=261747&it=b8590b71a702ab3788f0dda5d5c77d23"
    }
}
```

--------------------------------

### Nomenclator serii documente

Source: https://www.oblio.eu/api

Returns the list of document series for a specific company.

```APIDOC
## GET /nomenclature/series

### Description
Returns the list of document series for a specific company.

### Method
GET

### Endpoint
https://www.oblio.eu/api/nomenclature/series

### Parameters
#### Query Parameters
- **cif** (string) - Required - CIF of the company

### Request Example
```bash
curl -H "Authorization: Bearer 67d6f8817c28d698bdae35728c7a30b02a75bd4d" -X GET "https://www.oblio.eu/api/nomenclature/series?cif=RO37311090"
```

### Response
#### Success Response (200)
- **data** (array) - List of document series
  - **type** (string) - Document type
  - **name** (string) - Series name
  - **start** (string) - Starting number of the series
  - **next** (string) - Next number in the series
  - **default** (boolean) - Whether this is the default series

### Response Example
```json
{
 "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
        }
    ]
}
```
```
Tokens:
Raw