# API
## Crearea unui Invois
`POST` `https://invoicing.esempla.systems/api/v1/invoice`
1\. Indicam Identificatorul de la Provaiderul din SSO, in cimpul "SYSTEM\_ID:" din docker-compose.yml si indeplinim comanda "docker-compose up"\
2\. Indeplinim "Authorization", pentru a importa organizatia si proectul din SSO in Invoicing\
3\. Adaugam "Headers", "Body Parameters" si cream Invoices
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | ------------------------------------------------------------------------------ |
| Authorization | string | indicam tokenul generat prin metoda: /api/v1/login in aplicatia SSO
|
#### Headers
| Name | Type | Description |
| ------------ | ------ | ---------------- |
| Content-Type | string | application/json |
#### Request Body
| Name | Type | Description |
| ------- | ------ | --------------------------------------------------- |
| idno | string | idno -ul clientului |
| service | string | adugam numarul, codului, serviciului, din Invoicing |
{% tabs %}
{% tab title="200 Exemplul rezultatului corect, a fost creat Invoices" %}
```javascript
{
"id": "0ee63c41-ea0a-4d09-a840-bb40798bf711"
}
```
{% endtab %}
{% tab title="400 1. Organizatia si Proectul din SSO au fost importate in Invoicing
2\. Dupa import, cauza in datele indicate incorect "Body", "Headers"" %}
```
{
"name": "Bad Request",
"message": "{\"idno\":[\"IDNO cannot be blank.\"],\"service\":[\"Service ID cannot be blank.\"]}",
"code": 405,
"status": 400,
"type": "yii\\web\\HttpException"
}
```
{% endtab %}
{% tab title="401 Incorect setat identificatorul de la provaider in cimpul "SYSTEM\_ID:" din docker-compose.yml" %}
```
Unauthorized (#401)
Unauthorized (#401)
{"name":"Forbidden","message":"","code":0,"status":403}
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 12:51:23
```
{% endtab %}
{% tab title="404 Problema cu metodata, este indicata incorect" %}
```javascript
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 13:56:04
```
{% endtab %}
{% endtabs %}
## Vizionarea listei Invoices
`GET` `https://invoicing.esempla.systems/api/v1/invoice/`
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | --------------- |
| Authorization | string | indicam Tokenul |
{% tabs %}
{% tab title="200 Exemplu rezultatului corect" %}
```
[
{
"code": "cc8bb444-a05f-4ae6-bbd7-558d33a2506b",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
},
{
"code": "0ee63c41-ea0a-4d09-a840-bb40798bf711",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
},
{
"code": "17af5c96-f4eb-4bd9-a569-52c46f59bd76",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
}
]
eroare: metodata este indicata incorect
{
"message": "Not found"
}
```
{% endtab %}
{% tab title="401 Tokenul a fost indicat gresit, sau nu este valabil" %}
```
Unauthorized (#401)
Unauthorized (#401)
{"name":"Unauthorized","message":"Your request was made with invalid credentials.","code":0,"status":401}
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 14:25:59
```
{% endtab %}
{% tab title="404 Problema cu metodata, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 14:33:08
```
{% endtab %}
{% endtabs %}
## Filtram Invoisurile din lista, dupa anumite criterii
`GET` `https://invoicing.esempla.systems/api/v1/invoice?service={{service_code}}&project={{project_name}}`
#### Path Parameters
| Name | Type | Description |
| ------- | ------ | --------------------------------- |
| Params | string | filtru |
| service | string | filtram dupa denmirea servisului |
| project | string | filtram dupa denumirea proectului |
#### Request Body
| Name | Type | Description |
| ------------- | ------ | --------------- |
| Authorization | string | indicam Tokenul |
{% tabs %}
{% tab title="200 Exemplul rezultatului corect" %}
```
[
{
"code": "cc8bb444-a05f-4ae6-bbd7-558d33a2506b",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
},
{
"code": "0ee63c41-ea0a-4d09-a840-bb40798bf711",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
},
{
"code": "17af5c96-f4eb-4bd9-a569-52c46f59bd76",
"project": "SSOProject",
"service": "123456789",
"sender": "1234567891011",
"beneficiary": "123456789",
"amount": 24990,
"tva": 4998,
"total": 29988
}
]
eroare: metoda este indicata incorect
eroare: criteriile de filtru din "Params" sunt indicate incorect
[]
```
{% endtab %}
{% tab title="401 Tokenul este gresit, sau nu este valabil" %}
```
Unauthorized (#401)
Unauthorized (#401)
Token is expired!
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 14:56:51
```
{% endtab %}
{% tab title="404 Problema cu metoda, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 15:05:10
```
{% endtab %}
{% endtabs %}
## Selectam si vizionam datele despre Invois dupa "Code"
`GET` `https://invoicing.esempla.systems/api/v1/invoice/{{code}}`
{{code}} - codul invoisului
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | --------------- |
| Authorization | string | indicam Tokenul |
{% tabs %}
{% tab title="200 Exemplul rezultatului corect" %}
```
{
"code": "17af5c96-f4eb-4bd9-a569-52c46f59bd76",
"project": 3,
"amount": 24990,
"tva": 4998,
"total": 29988,
"beneficiary": "123456789",
"sender": "1234567891011",
"service": "InvoicingServices1"
}
eroare: codul serviciului nu exista
{
"message": "Not found"
}
```
{% endtab %}
{% tab title="401 Tokenul este indicat incorect" %}
```
Unauthorized (#401)
Unauthorized (#401)
{"name":"Unauthorized","message":"Your request was made with invalid credentials.","code":0,"status":401}
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 15:13:50
```
{% endtab %}
{% tab title="404 Problema cu metodata, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 15:22:07
```
{% endtab %}
{% endtabs %}
## Vizionam lista Serviciilor
`GET` `https://invoicing.esempla.systems/api/v1/service`
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | --------------- |
| Authorization | string | indicam Tokenul |
{% tabs %}
{% tab title="200 Exemplul rezultatului corect" %}
```
[
{
"code": "1234",
"name": "1",
"amount": 1234,
"description": "fasdfasdfasdf",
"override": true,
"target": "afdfdf",
"project": "SSOProject"
},
{
"code": "123456789",
"name": "InvoicingServices1",
"amount": 24990,
"description": "d wf qwef qwef wq e fq",
"override": true,
"target": " eqwe fqwef qwf qwf qwe",
"project": "SSOProject"
}
]
```
{% endtab %}
{% tab title="401 Tokenul este indicata incorect" %}
```
Unauthorized (#401)
Unauthorized (#401)
{"name":"Unauthorized","message":"Your request was made with invalid credentials.","code":0,"status":401}
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 15:35:39
```
{% endtab %}
{% tab title="404 Problema cu metodata, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 15:40:13
```
{% endtab %}
{% endtabs %}
## Selectarea Serviciilor dupa suma
`GET` `https://invoicing.esempla.systems/api/v1/service?amount=100`
100 - criteriul de selectare
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | -------------------------------------------------- |
| amount | string | se indica suma dupa care va fi efectuat selectarea |
| Authorization | string | indicam Tokinul |
{% tabs %}
{% tab title="200 Exemplul rezultatului corect" %}
```
[
{
"code": "1234",
"name": "1",
"amount": 1234,
"description": "fasdfasdfasdf",
"override": true,
"target": "afdfdf",
"project": "SSOProject"
}
]
eroare: nu exista asa suma
[]
```
{% endtab %}
{% tab title="401 Tokenul este indicat incorect, sau nu e valabil" %}
```
Unauthorized (#401)
Unauthorized (#401)
Token is expired!
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 16:03:16
```
{% endtab %}
{% tab title="404 Probleme cu metoda, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-19 16:08:44
```
{% endtab %}
{% endtabs %}
## Selectam si vizionam datele despre servis dupa "Code"
`GET` `https://invoicing.esempla.systems/api/v1/service/{{code}}`
{{code}} - codul serviciului
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | --------------- |
| Authorization | string | indicam Tokenul |
{% tabs %}
{% tab title="200 Exemplul rezultatuliu corect" %}
```
{
"code": "1234",
"name": "1",
"amount": 1234,
"description": "fasdfasdfasdf",
"override": true,
"target": "afdfdf",
"project": "SSOProject"
}
eroare: nu exista srvis cu codul imdicat
{
"message": "Not found"
}
```
{% endtab %}
{% tab title="401 Tokenult este indicat incorect sau nu e valabil" %}
```
Unauthorized (#401)
Unauthorized (#401)
{"name":"Unauthorized","message":"Your request was made with invalid credentials.","code":0,"status":401}
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-20 07:14:29
```
{% endtab %}
{% tab title="404 Problema cu metodata, este indicata incorect" %}
```
Not Found (#404)
Not Found (#404)
Page not found.
The above error occurred while the Web server was processing your request.
Please contact us if you think this is a server error. Thank you.
2019-03-20 07:16:41
```
{% endtab %}
{% endtabs %}
## Crearea tranzactiei
`POST` `​https://invoicing.esempla.systems/api/v1/extras`
#### Path Parameters
| Name | Type | Description |
| ------------- | ------ | ---------------------- |
| Authorization | string | Indicam Tokenul bancar |
#### Headers
| Name | Type | Description |
| ------------ | ------ | -------------------------------- |
| Content-Type | string | indicam rindul: application/json |
{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://api.govtech.esempla.systems/invoicing/api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.