Current version: 1.0
\n1NVOICE.NET, aligned with BIR’s electronic invoicing initiatives, offers a modern electronic invoice solution for streamlined tax compliance and reporting in the Philippines. Designed for efficiency, security, and real-time processing, it empowers businesses to automate invoicing and meet government standards while supporting the country’s digital transformation.
\nWe, as one of the leading Computerized Accounting System (CAS) and Tax Services provider here in the Philippines, created 1Nvoice API to assist our clients in transitioning their legacy system to CAS.
\nOur APIs includes the following:
\nAuthentication - An endpoint to establish secure connection between our client and our server
\nInvoice Sending - An endpoint to encode and view Invoice transactions
\nThe API can be access via the URL : https://1nvoice.net/api
\nUpdate History:
\n- Return list of invoices per page
\nPre-requisite:
\nHeader
\nURL
\nRequest Parameter
\nThe following fields are returned :
\nNote:
\nA token is required to submit request
\nTransaction response is encrypted. Use the secret key to decrypt response (AES256)
\n- Return list of invoices per page
\nPre-requisite:
\nHeader
\nURL
\npage number
\nsearch (optional) - keyword to search
\nThe following fields are returned :
\nNote:
\nA token is required to submit request
\nTransaction response is encrypted. Use the secret key to decrypt response (AES256)
\n- Write invoices to Helix System
\nPre-requisite:
\nHeader
\nThe following fields composes the JSON object:
\nNote:
\nA token is required to submit request
\nData should be encrypted (AES256) using the secret key returned during the authentication process
\n- Delete invoices from Helix System
\nPre-requisite:
\nHeader
\nURL
\ntransmitno - transmit number to delete
\nNote:
\nA token is required to submit request
\n","auth":{"type":"apikey","apikey":{"basicConfig":[]},"isInherited":true,"source":{"_postman_id":"1da9e087-7dfb-4d19-91d5-319635015f93","id":"1da9e087-7dfb-4d19-91d5-319635015f93","name":"1Nvoice.net API","type":"collection"}},"urlObject":{"path":["resources","v1","invoice","delete"],"host":["https://1nvoice.net/api"],"query":[{"key":"transmitno","value":"0412024112057163"}],"variable":[]}},"response":[{"id":"daa2d398-c29a-4628-ba37-d8f5b772a3de","name":"Delete Successful","originalRequest":{"method":"POST","header":[{"key":"token","value":"743c6c2bca6ae1867c80db6df7d2411ae19be7d4cfba219e88de3c35d527c8b1e0dc9ffcb07b20d3f5398bcbadea35090684b577608fa16faa83cfe0e08a1615c417dbe9ef8fedabec8dc3aad2c6e08de7d0aea3ae5443b18ec8da537bf220f3","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"payload\": \"A4xUzwAUSTZU88ztLFjbv8oY7vFAyPIHhG0koPsHWEGFPLcAAPmpOqmrL+UYW8J25jrfBYX74Wt0ZmhFH6eZpYrfsCk0Bu38fj3LcU5VdKAeTOvq7o64N2jGE2ObySOaOlrU/u6GRhcxJQzEJanwNqb1/0jLu/bu1K7locukOl2kl3bVroDAP9iMQNEe2vfjwfy2+P90DL5S9pxGgJP8C7hJWeS1bM/y5WzoPo4Rbx84iLjwn6tiq9hvqC8Xg2wdnAlZ2G1GFnEBlEh7TimCnJV+9X5GCe/9cCru+6m4Gh8zbOGXaq/PYvIIaJT+wuAEB0Hgu0+Fi9g+RSc+VuHwDvOxgi4L2TPBZqp0qhbwsW+Y7DvYN8+DnhgvnH6Ah0DC2mrZS6p5UPYbECVJYjrUZtV16uYlsdniDYFa6k2kEoXZzaMg7jMMhz81voHt0wzyOxAZy7AdrKbGLi/n1FvqlAM+GOX0EoK0aQMmVHbv1BLlV2YzC57b0hfI07z6c98dApoL4Ztuv5Ivix8UEZ7GgT/9O0LdgK5ZDT+DTA5PMcHdrVM7ysF1S49IMzKR4oIlyCkdWDs8uoa5DrfGUwV36BeSfLqysEFmvcwBMfhKxADmdHzMUxlWz3a6ZDm3jkZHYktsIv8w+oiAgO/0b3vFTUm2i7fJUeLl5u/miz4kh6bQY9KKTJNwjEMQKjPqdL2fI7nIMAdlaOrK9b/amN5zQgbtx/rNzQH/7Ke/3DvmUq6SdErz/NIJzactmfFTtg64aIZyVLSQOOr4CbySiPkMs8y1VPFuMW/k5epC7NRJChEPyAL61em6xHrUCejg1me+bZip6DdefzrobtrKQRYI9ktSQmDzvCKHEKyeB+6eOeeHJ7XdUS0Kuq2Av0SE7uAL\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://1nvoice.net/api/api/resources/v1/invoice/delete?transmitno=0412024112057163","host":["https://1nvoice.net/api"],"path":["api","resources","v1","invoice","delete"],"query":[{"key":"transmitno","value":"0412024112057163"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"Payara Server 5.2020.4 #badassfish"},{"key":"X-Powered-By","value":"Servlet/4.0 JSP/2.3 (Payara Server 5.2020.4 #badassfish Java/Oracle Corporation/1.8)"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"47"},{"key":"X-Frame-Options","value":"SAMEORIGIN"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 200,\n \"message\": \"Success\",\n \"success\": true\n}"}],"_postman_id":"8ea05385-a6f6-4475-bc7d-657915af5c59"}],"id":"10283693-3623-470d-bce4-a3e51562bb4b","description":"Web service to add,delete, or view sales records to 1Nvoice system.
\nThis document outlines the process flow of the invoice endpoint. The application facilitates the generation of invoices for e-commerce transactions. When a customer completes an online payment, the payment gateway/e-commerce application transmits transaction data to the invoice application for invoice recording and invoice number assignment.
\nCustomer – Purchases items on the e-commerce website.
\nE-commerce Website – Manages product listings, cart, and checkout process.
\nPayment Gateway/Provider – Processes the payment and sends transaction data.
\nInvoice Application (1Nvoice) – Records the transaction and generates an invoice/assign invoice number.
\nClient (E-commerce Owner) – Reviews and manages invoices.
\nThe customer selects items on the e-commerce website and proceeds to checkout.
\nThe e-commerce website calculates the total amount and directs the customer to the payment gateway.
\nThe customer enters payment details and submits the payment.
\nThe payment gateway processes the transaction.
\nUpon successful payment, the payment gateway sends transaction details to the e-commerce website.
\nThe payment gateway or the e-commerce website can send the transaction details to 1Nvoice for invoice processing
\nThe payment gateway transmits transaction data, including:
\nCustomer details (name, email, etc.)
\nOrder details (items purchased, quantity, total amount)
\nPayment details (mode of payment, amount, date)
\nThe invoice application receives the transaction data.
\nAn invoice number is assigned based on the approved series.
\nThe invoice application may send a notification to the customer via email or sms containing:
\nInvoice number
\nOrder summary
\nPayment confirmation
\nThe client (e-commerce owner) can:
\nThe following fields composes the JSON object:
\nAdditional documents will be required before evaluation. A reference number will be returned upon submission of request
\n","auth":{"type":"noauth","isInherited":true,"source":{"_postman_id":"ec18900d-3592-4a2f-8ad9-eb3e3e88da92","id":"ec18900d-3592-4a2f-8ad9-eb3e3e88da92","name":"Registration","type":"folder"}},"urlObject":{"path":["api","resources","v1","register"],"host":["https://1nvoice.net/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"10b992aa-5735-455d-95f8-0ca3e511de27"}],"id":"ec18900d-3592-4a2f-8ad9-eb3e3e88da92","description":"Web service to register to 1Nvoice system. Please note that this undergoes a manual approval process
\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"e00ad64b-8ae9-4d7e-bbbf-51f407e35b8f","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"260cd0b1-e00a-4734-ae80-f758dac15ce6","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"ec18900d-3592-4a2f-8ad9-eb3e3e88da92"},{"name":"Authenticate","id":"c785abf0-009f-42ef-a773-817d65359e51","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"companyid","value":"HMR"}],"body":{"mode":"raw","raw":"{\r\n \"data\": \"ILsGamv+8ODUjtLbna8H58JKcQWgQA1z6eL3GfidP3pcchVsr84mRtaHtJPwQfX5HlSNVKbatedOAv73rm9+JXhZI7Klh0zjUYLG8l/rN/6jvTHcrk375q16H/uivoCHA9S876Wb3ZWiAL0x1RG+Lb107ehaArve3yjs+qx3llezRrIqMepn6UPU98sjtE2O1PuZPRFHBjifNKfR8znX5wLXY2PKTaENgQ2eK8U3j3pjaZSs5ifg6/kRHGEEdyQBpji2D+0WakBGj0S+f/GA7AC9TgpkwcWexz4w1qHDzAI+TAPgRoLkkk+2LjJpdgDeNb5HLzij1ySbjqrAjBDRCg==\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://1nvoice.net/api/resources/auth","description":"Note:
\nAn RSA encryption is required to generate a Token
\nTo create a token request:
\nInclude the header: companyid to the request
\nEncrypt the JSON Object with the following format:
\nSample Format:
\n{\"companyid\":\"1\",\"username\":\"sample@email.com\",\"password\":\"sample_password\",\"tempsecret\":\"RKAASoQDWK4Se4xcNxbqNeJjyW2FHG11\"}
\nNote:
\nThe public key to encrypt the JSON Object will be provided upon request
\n