Philippines
Enabling support for Philippines involves confirming prerequisites and product IDs, registering with the Bureau of Internal Revenue (BIR) tax authority, and setting up credentials.
Prerequisites
User ID, password, accreditation ID, application ID and application secret, obtained from the BIR's Electronic Invoicing/Receipting System (EIS).
A signing certificate file and signing key, obtained from the BIR's EIS.
Available products
ph_PHInvoice_CAS_2.0
ph_PHInvoice_POS_2.0
ph_PHInvoice_CRM_2.0
PH_DOCUMENT_1_2.0
Register with the Philippines tax authority
Configure the transmission credentials for the Philippines
Samples for uploading transmission credentials for the Philippines
After you have created a company and a product, and have obtained the Electronic Invoicing/Receipting System (EIS) credentials, you can call the Create settings endpoint and upload the transmission credentials.
Request sample
Request sample for uploading new transmissions credentials:
curl --location --request POST 'https://api-test.sovos.com/v2/configurations/organizations/YOUR-ORG-ID/settings' \
--header 'x-correlationId: developer-guide' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"context": "transmission",
"configurations": [
{
"name": "partner_credentials_BIR",
"value": {
"userId": INSERT-USERID-HERE,
"password": INSERT-PASSWORD-HERE,
"accreditationId": INSERT-ACCREDITATIONID-HERE,
"applicationId": INSERT-APPLICATIONID-HERE,
"applicationSecretKey": INSERT-APPLICATIONSECRET-HERE
},
"scope": {
"category": "ph_inv",
"productId": "ph_PHInvoice_POS_2.0",
"orgId": YOUR-ORG-ID,
"taxId": YOUR-COMPANY-TAXID
}
}
]
}
]'Response sample
Response sample for uploading new transmissions credentials:
{
"status": 201,
"message": "Created",
"success": true,
"timestamp": 1664826411521,
"data": [
{
"message": "Configurations are created",
"statusCode": 201,
"configurationContextResponse": {
"context": "Transmission",
"configurations": [
{
"id": SETTING-ID,
"name": "partner_credentials_BIR",
"value": {
"userId": INSERT-USERID-HERE,
"password": INSERT-PASSWORD-HERE,
"accreditationId": INSERT-ACCREDITATIONID-HERE,
"applicationId": INSERT-APPLICATIONID-HERE,
"applicationSecretKey": INSERT-APPLICATIONSECRET-HERE
},
"scope": {
"category": "ph_inv",
"productId": "ph_PHInvoice_POS_2.0",
"orgId": YOUR-ORG-ID,
"taxId": YOUR-COMPANY-TAXID
},
"auditData": {
"createdAt": 1664826410,
"createdBy": "user@company.com",
"isDeleted": false,
"version": 1
}
}
]
}
}
]
}Configure the signing credentials for the Philippines
Samples for uploading signing credentials for the Philippines
Request and response samples for uploading new signing credentials using the dedicated Create settings endpoint.
Request sample
Request sample for uploading new transmissions credentials:
curl --location --request POST 'https://api-test.sovos.com/v2/configurations/organizations/YOUR-ORG-ID/settings' \
--header 'x-correlationId: developer-guide' \
--data-raw '[
{
"context": "signing",
"configurations": [
{
"name": "credentials",
"value": {
"certificateFileData": INSERT-CERT-FILEDATA-HERE,
"keyId": INSERT-KEYID-HERE
},
"scope": {
"category": "ph_inv",
"productId": "ph_PHInvoice_POS_2.0",
"orgId": YOUR-ORG-ID
"taxId": YOUR-COMPANY-TAXID
}
}
]
}
]'Response sample
Response sample for uploading new transmissions credentials:
{
"status": 201,
"message": "Created",
"success": true,
"timestamp": 1667465886908,
"data": [
{
"message": "Configurations are created",
"statusCode": 201,
"configurationContextResponse": {
"context": "Signing",
"configurations": [
{
"id": SETTING-ID,
"name": "credentials",
"value": {
"certificateFileData": INSERT-CERT-FILEDATA-HERE,
"keyId": INSERT-KEYID-HERE
},
"scope": {
"category": "ph_inv",
"productId": "ph_PHInvoice_POS_2.0",
"orgId": YOUR-ORG-ID,
"taxId": YOUR-COMPANY-TAXID
},
"auditData": {
"createdAt": 1667465886,
"createdBy": "user@company.com",
"isDeleted": false,
"version": 1
}
}
]
}
}
]
}