Add Pos Session Log

Description: Logs detailed transaction data for a POS session, such as invoices, receipts, or returns. Requires authentication headers (apikey, apiconnection, secure-business-key, userToken). The request body, submitted as form data, includes fields for various transaction types (e.g., cash, visa, credit notes) with their IDs, references, totals, and dates. This endpoint is critical for maintaining an audit trail of POS activities. Returns a JSON object confirming the log entry with a success message and possibly the log details. Record transaction details for a POS session for auditing purposes.

Headers

Key	Value	Description	Type	Required
`apikey`	`5f28583f26a1a`	API key for authentication; contact support to obtain.	`string`	Yes
`apiconnection`	`appmobile`	Connection type; contact support to obtain.	`string`	Yes
`secure-business-key`	`4765066450c0bd66325.48403130`	Business-specific key; contact support for valid values.	`string`	Yes
`userToken`	`09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9`	User token from authentication API. `Required` (Get user token from `https://testaccounts.vodoerp.com/api/login` or `https://accounts.vodoerp.com/api/login`)	`string`	Yes

Body or Form Data

Key	Value	Description	Type	Required
`pos_session_id`	`5`	ID of the POS session.	`string`	Yes
`invoice_id`	`654`	Invoice ID.	`string`	No
`invoice_reference`	`4`	Invoice reference number.	`string`	No
`invoice_total`	`76`	Total invoice amount.	`string`	No
`invoice_created_date`	`2025-02-27`	Date the invoice was created.	`string`	No
`cash_receipt_id`	`4`	Cash receipt ID.	`string`	No
`cash_receipt_reference`	`5`	Cash receipt reference number.	`string`	No
`cash_receipt_total`	`76`	Total cash receipt amount.	`string`	No
`cash_receipt_created_date`	`2025-02-27`	Date the cash receipt was created.	`string`	No
`visa_receipt_id`	`75`	Visa receipt ID.	`string`	No
`visa_receipt_reference`	`9`	Visa receipt reference number.	`string`	No
`visa_receipt_total`	`46`	Total visa receipt amount.	`string`	No
`visa_receipt_created_date`	`2025-02-27`	Date the visa receipt was created.	`string`	No
`customer_receipt_id`	`45`	Customer receipt ID.	`string`	No
`customer_receipt_reference`	`846`	Customer receipt reference number.	`string`	No
`customer_receipt_total`	`8498`	Total customer receipt amount.	`string`	No
`customer_receipt_created_date`	`2025-02-27`	Date the customer receipt was created.	`string`	No
`type`	`returns`	Transaction type (e.g., "returns").	`string`	Yes
`credit_note_id`	`45`	Credit note ID.	`string`	No
`credit_note_reference`	`846`	Credit note reference number.	`string`	No
`credit_note_total`	`8498`	Total credit note amount.	`string`	No
`credit_note_created_date`	`2025-02-27`	Date the credit note was created.	`string`	No
`cash_payment_id`	`45`	Cash payment ID.	`string`	No
`cash_payment_reference`	`846`	Cash payment reference number.	`string`	No
`cash_payment_total`	`8498`	Total cash payment amount.	`string`	No
`cash_payment_created_date`	`2025-02-27`	Date the cash payment was created.	`string`	No

curl --location --request POST 'https://www.testecommerce.vodoerp.com/api/v1/pos/add_pos_session_log' \ --header 'apikey: 5f28583f26a1a' \ --header 'apiconnection: appmobile' \ --header 'secure-business-key: 4765066450c0bd66325.48403130' \ --header 'userToken: 09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9' \ --form 'pos_session_id="5"' \ --form 'invoice_id="654"' \ --form 'invoice_reference="4"' \ --form 'invoice_total="76"' \ --form 'invoice_created_date="2025-02-27"' \ --form 'cash_receipt_id="4"' \ --form 'cash_receipt_reference="5"' \ --form 'cash_receipt_total="76"' \ --form 'cash_receipt_created_date="2025-02-27"' \ --form 'visa_receipt_id="75"' \ --form 'visa_receipt_reference="9"' \ --form 'visa_receipt_total="46"' \ --form 'visa_receipt_created_date="2025-02-27"' \ --form 'customer_receipt_id="45"' \ --form 'customer_receipt_reference="846"' \ --form 'customer_receipt_total="8498"' \ --form 'customer_receipt_created_date="2025-02-27"' \ --form 'type="returns"' \ --form 'credit_note_id="45"' \ --form 'credit_note_reference="846"' \ --form 'credit_note_total="8498"' \ --form 'credit_note_created_date="2025-02-27"' \ --form 'cash_payment_id="45"' \ --form 'cash_payment_reference="846"' \ --form 'cash_payment_total="8498"' \ --form 'cash_payment_created_date="2025-02-27"'

Request

Header Params

apikey

string

required

You must contact support to get the apikey.

Example:

5f28583f26a1a

apiconnection

string

required

You must contact support to get the apiconnection.

Example:

appmobile

secure-business-key

string

required

You must contact support to get the secure-business-key like: 4765066450c0bd66325.48403130
728106399db2b289783.89154521
2680667168f2f8a68f6.12561200
140356399db2b2c32f0.25237063
96701678e330f31f768.22400604
14807664478836358b0.31329842

Example:

4765066450c0bd66325.48403130

userToken

string

required

Get user token from
https://testaccounts.vodoerp.com/api/login
or
https://accounts.vodoerp.com/api/login

Example:

09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9

Body Params multipart/form-data

pos_session_id

string

required

Example:

invoice_id

string

required

Example:

654

invoice_reference

string

required

Example:

invoice_total

string

required

Example:

invoice_created_date

string

required

Example:

2025-02-27

cash_receipt_id

string

required

Example:

cash_receipt_reference

string

required

Example:

cash_receipt_total

string

required

Example:

cash_receipt_created_date

string

required

Example:

2025-02-27

visa_receipt_id

string

required

Example:

visa_receipt_reference

string

required

Example:

visa_receipt_total

string

required

Example:

visa_receipt_created_date

string

required

Example:

2025-02-27

customer_receipt_id

string

required

Example:

customer_receipt_reference

string

required

Example:

846

customer_receipt_total

string

required

Example:

8498

customer_receipt_created_date

string

required

Example:

2025-02-27

type

string

required

Example:

returns

credit_note_id

string

required

Example:

credit_note_reference

string

required

Example:

846

credit_note_total

string

required

Example:

8498

credit_note_created_date

string

required

Example:

2025-02-27

cash_payment_id

string

required

Example:

cash_payment_reference

string

required

Example:

846

cash_payment_total

string

required

Example:

8498

cash_payment_created_date

string

required

Example:

2025-02-27

Add Pos Session Log

Request

Responses