API Definition to interact with Prana platform
Prana API (1.0)
https://api.prana.software/api/v1/entry/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://api.prana.software/api/v1/entry/{id}'Response
application/json
{ "id": 1, "code": 10123, "periodId": 2024, "journal": { "id": 1, "code": "SALES", "description": "Sales Journal" }, "entryDate": "2024-05-15", "valueDate": "2024-05-16", "currency": { "id": 1, "code": "strin", "description": "string", "nomenclature": "strin", "isoCode": "USD", "changeValue": 0, "significantDecimalsDocuments": 0, "intermediateDecimalsDocuments": 0, "decimalsCalculatePrices": 0, "decimalsCalculateCosts": 0 }, "currencyChange": 1.12, "document": "DOC-2024-015", "originalDocument": "INV-2024-077", "observations": "Manual adjustment for reconciliation", "debit": 1500, "credit": 1500, "consolidated": true, "origin": "AMORTIZATION", "vatRecord": { "id": 1, "vatType": "GENERAL", "billingSeriesCode": "BS001", "billingSeriesDescription": "Standard Billing Series", "code": 12345, "vatOperationTypeCode": "E01", "vatOperationTypeDescription": "Intra-community acquisition of goods", "description": "Purchase of office supplies with general VAT", "cif": "B12345678", "invoiceDate": "2024-05-15", "accountingDate": "2024-05-16", "totalAmount": 1500, "invoiceDescription": "Purchase of raw materials" }, "paymentId": 5678, "exported": false, "controlCode": 445, "lines": { "id": 1, "lineNumber": 1, "concept": { … }, "conceptDescription": "Purchase of office supplies", "extension": "EXT-REF-01", "document": "INV-2024-099", "account": { … }, "debit": 1200, "credit": 1200, "reconciliation": 0, "projectId": 45, "currencyAmount": 1000, "currencyDebit": 500, "currencyCredit": 500, "tags": [ … ] }, "files": { "id": 1, "token": "729eda1d03b34634b8e3c81a8b2d0974", "url": "https://apihost.com/file/729eda1d03b34634b8e3c81a8b2d0974", "fileName": "invoice_2023.pdf", "fileExtension": "pdf", "fileSize": 1048576, "modifiedOn": "2024-08-07T18:10:55" }, "receiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "purchaseReceiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "supplierCode": "string", "supplierBusinessName": "string", "supplierName": "string" }, "remittanceReceipt": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "closingType": "OPENING" }
Bodyapplication/jsonrequired
Additional observations or comments for the entry
Example: "Manual adjustment for reconciliation"
Enum"AMORTIZATION""BALANCE""RECEIPT""PAYMENT""POS_INVOICE""DELIVERY_NOTE""PAYROLL""SAGE""BANK"
Identifier of the receipt collection associated with the entry
Example: 321
Identifier of the purchase receipt collection associated with the entry
Example: 654
Identifier of the remittance receipt associated with the entry
Example: 789
https://api.prana.software/api/v1/entry/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://api.prana.software/api/v1/entry/{id}' \
-H 'Content-Type: application/json' \
-d '{
"id": 10123,
"code": 5001,
"journal": 3,
"entryDate": "2024-05-15",
"valueDate": "2024-05-16",
"currency": 1,
"currencyChange": 1.123456789,
"document": "DOC-2024-015",
"originalDocument": "INV-2024-077",
"observations": "Manual adjustment for reconciliation",
"debit": 1500,
"credit": 1500,
"consolidated": false,
"origin": "AMORTIZATION",
"vatRecord": 25,
"paymentId": 5678,
"exported": true,
"controlCode": 445,
"lines": {
"id": 1001,
"entry": 5001,
"lineNumber": 1,
"concept": 200,
"conceptDescription": "Purchase of office supplies",
"extension": "EXT-REF-01",
"document": "INV-2024-099",
"account": 6000,
"credit": 1200,
"debit": 1200,
"reconciliation": 0,
"projectId": 45,
"currencyAmount": 1000,
"currencyDebit": 500,
"currencyCredit": 500,
"tags": [
"adjustment",
"VAT"
]
},
"files": {
"id": 0,
"token": "string",
"fileName": "string",
"fileExtension": "string",
"fileSize": 0
},
"receiptCollection": 321,
"purchaseReceiptCollection": 654,
"remittanceReceipt": 789,
"closingType": "YEAR_END"
}'Response
application/json
{ "id": 1, "code": 10123, "periodId": 2024, "journal": { "id": 1, "code": "SALES", "description": "Sales Journal" }, "entryDate": "2024-05-15", "valueDate": "2024-05-16", "currency": { "id": 1, "code": "strin", "description": "string", "nomenclature": "strin", "isoCode": "USD", "changeValue": 0, "significantDecimalsDocuments": 0, "intermediateDecimalsDocuments": 0, "decimalsCalculatePrices": 0, "decimalsCalculateCosts": 0 }, "currencyChange": 1.12, "document": "DOC-2024-015", "originalDocument": "INV-2024-077", "observations": "Manual adjustment for reconciliation", "debit": 1500, "credit": 1500, "consolidated": true, "origin": "AMORTIZATION", "vatRecord": { "id": 1, "vatType": "GENERAL", "billingSeriesCode": "BS001", "billingSeriesDescription": "Standard Billing Series", "code": 12345, "vatOperationTypeCode": "E01", "vatOperationTypeDescription": "Intra-community acquisition of goods", "description": "Purchase of office supplies with general VAT", "cif": "B12345678", "invoiceDate": "2024-05-15", "accountingDate": "2024-05-16", "totalAmount": 1500, "invoiceDescription": "Purchase of raw materials" }, "paymentId": 5678, "exported": false, "controlCode": 445, "lines": { "id": 1, "lineNumber": 1, "concept": { … }, "conceptDescription": "Purchase of office supplies", "extension": "EXT-REF-01", "document": "INV-2024-099", "account": { … }, "debit": 1200, "credit": 1200, "reconciliation": 0, "projectId": 45, "currencyAmount": 1000, "currencyDebit": 500, "currencyCredit": 500, "tags": [ … ] }, "files": { "id": 1, "token": "729eda1d03b34634b8e3c81a8b2d0974", "url": "https://apihost.com/file/729eda1d03b34634b8e3c81a8b2d0974", "fileName": "invoice_2023.pdf", "fileExtension": "pdf", "fileSize": 1048576, "modifiedOn": "2024-08-07T18:10:55" }, "receiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "purchaseReceiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "supplierCode": "string", "supplierBusinessName": "string", "supplierName": "string" }, "remittanceReceipt": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "closingType": "OPENING" }
Bodyapplication/jsonrequired
Additional observations or comments for the entry
Example: "Manual adjustment for reconciliation"
Enum"AMORTIZATION""BALANCE""RECEIPT""PAYMENT""POS_INVOICE""DELIVERY_NOTE""PAYROLL""SAGE""BANK"
Identifier of the receipt collection associated with the entry
Example: 321
Identifier of the purchase receipt collection associated with the entry
Example: 654
Identifier of the remittance receipt associated with the entry
Example: 789
https://api.prana.software/api/v1/entry
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.prana.software/api/v1/entry \
-H 'Content-Type: application/json' \
-d '{
"id": 10123,
"code": 5001,
"journal": 3,
"entryDate": "2024-05-15",
"valueDate": "2024-05-16",
"currency": 1,
"currencyChange": 1.123456789,
"document": "DOC-2024-015",
"originalDocument": "INV-2024-077",
"observations": "Manual adjustment for reconciliation",
"debit": 1500,
"credit": 1500,
"consolidated": false,
"origin": "AMORTIZATION",
"vatRecord": 25,
"paymentId": 5678,
"exported": true,
"controlCode": 445,
"lines": {
"id": 1001,
"entry": 5001,
"lineNumber": 1,
"concept": 200,
"conceptDescription": "Purchase of office supplies",
"extension": "EXT-REF-01",
"document": "INV-2024-099",
"account": 6000,
"credit": 1200,
"debit": 1200,
"reconciliation": 0,
"projectId": 45,
"currencyAmount": 1000,
"currencyDebit": 500,
"currencyCredit": 500,
"tags": [
"adjustment",
"VAT"
]
},
"files": {
"id": 0,
"token": "string",
"fileName": "string",
"fileExtension": "string",
"fileSize": 0
},
"receiptCollection": 321,
"purchaseReceiptCollection": 654,
"remittanceReceipt": 789,
"closingType": "YEAR_END"
}'Response
application/json
{ "id": 1, "code": 10123, "periodId": 2024, "journal": { "id": 1, "code": "SALES", "description": "Sales Journal" }, "entryDate": "2024-05-15", "valueDate": "2024-05-16", "currency": { "id": 1, "code": "strin", "description": "string", "nomenclature": "strin", "isoCode": "USD", "changeValue": 0, "significantDecimalsDocuments": 0, "intermediateDecimalsDocuments": 0, "decimalsCalculatePrices": 0, "decimalsCalculateCosts": 0 }, "currencyChange": 1.12, "document": "DOC-2024-015", "originalDocument": "INV-2024-077", "observations": "Manual adjustment for reconciliation", "debit": 1500, "credit": 1500, "consolidated": true, "origin": "AMORTIZATION", "vatRecord": { "id": 1, "vatType": "GENERAL", "billingSeriesCode": "BS001", "billingSeriesDescription": "Standard Billing Series", "code": 12345, "vatOperationTypeCode": "E01", "vatOperationTypeDescription": "Intra-community acquisition of goods", "description": "Purchase of office supplies with general VAT", "cif": "B12345678", "invoiceDate": "2024-05-15", "accountingDate": "2024-05-16", "totalAmount": 1500, "invoiceDescription": "Purchase of raw materials" }, "paymentId": 5678, "exported": false, "controlCode": 445, "lines": { "id": 1, "lineNumber": 1, "concept": { … }, "conceptDescription": "Purchase of office supplies", "extension": "EXT-REF-01", "document": "INV-2024-099", "account": { … }, "debit": 1200, "credit": 1200, "reconciliation": 0, "projectId": 45, "currencyAmount": 1000, "currencyDebit": 500, "currencyCredit": 500, "tags": [ … ] }, "files": { "id": 1, "token": "729eda1d03b34634b8e3c81a8b2d0974", "url": "https://apihost.com/file/729eda1d03b34634b8e3c81a8b2d0974", "fileName": "invoice_2023.pdf", "fileExtension": "pdf", "fileSize": 1048576, "modifiedOn": "2024-08-07T18:10:55" }, "receiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "purchaseReceiptCollection": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "supplierCode": "string", "supplierBusinessName": "string", "supplierName": "string" }, "remittanceReceipt": { "id": 1, "orderNumber": 1, "collectionDate": "2024-03-15", "country": "Spain", "accountCode": 572000003, "observations": "First payment received via bank transfer.", "amount": 1000.5, "accounted": true, "bankName": "Bank of Spain", "customerCode": "CUST001", "customerBusinessName": "Clavei S.A.", "customerName": "Ana MartÃnez" }, "closingType": "OPENING" }
https://api.prana.software/api/v1/entry/search
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://api.prana.software/api/v1/entry/search \
-H 'Content-Type: application/json' \
-d '{
"condition": {
"field": "name",
"value": "Example Value",
"type": "EQ",
"endValue": 100,
"innerConditions": [
{}
],
"conditionType": "AND",
"empty": false,
"compareFields": false
},
"sortCriteria": [
{
"sortField": "name",
"sortDirection": "ASC"
}
],
"pageNumber": 0,
"pageSize": 20
}'Response
application/json
{ "data": [ { … } ], "page": 0, "total": 150, "pages": 14, "size": 10 }