# 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 %}