{"id":7331,"date":"2026-10-07T10:03:27","date_gmt":"2026-10-07T10:03:27","guid":{"rendered":"https:\/\/profitaa.com\/ng\/?post_type=docs&p=7331"},"modified":"2026-10-07T10:05:14","modified_gmt":"2026-10-07T10:05:14","password":"","slug":"nrs-mbs-api-documentation","status":"publish","type":"docs","link":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/","title":{"rendered":"NRS MBS API Documentation"},"content":{"rendered":"

# Profitaa ERP \u2014 Federal Inland Revenue Service (FIRS) MBS API Integration<\/strong><\/p>\n

 <\/p>\n

Welcome to the Profitaa integration specs. This reference outlines how multi-tenant business nodes programmatically interact with the Merchant Buyer Solution (MBS) core ledger for real-time electronic invoice pre-clearance and cryptographic validation.<\/p>\n

 <\/p>\n

## 1. Protocol Architecture<\/strong>
\n– **Transport**: HTTPS POST over TLS 1.3
\n– **Data Formats**: UBL XML 2.1 \/ PEPPOL BIS Billing 3.0 (with fallback JSON schema mapping structures)
\n– **Authentication**: Stateless Tenant Header Injection (`x-api-key`, `x-api-secret`)<\/p>\n

 <\/p>\n

## 2. Core Operational Endpoints<\/strong><\/p>\n

### Real-Time Invoice Signing & Registration
\n– **Route**: `POST \/api\/v1\/invoice\/sign`
\n– **Description**: Submits finalized transaction arrays natively to the ledger. This route computes macro monetary total calculations, maps standard HSN tariff matrix filters, validates output tax lines, and permanently saves documents to the merchant account portal view dashboard.<\/p>\n

– **Success Status**: `201 Created` \/ `200 OK`<\/p>\n

 <\/p><\/blockquote>\n

### Stateless dry-run Dry Validation<\/strong>
\n– **Route**: `POST \/api\/v1\/invoice\/validate`
\n– **Description**: Validates data type arrays, element lengths, and calculation balances statelessly in memory without modifying backend storage histories.<\/p>\n

 <\/p>\n

### Invoice Lifecycle Amendments (Debit\/Credit Notes)<\/strong>
\n– **Route**: `PATCH \/api\/v1\/invoice\/update`
\n– **Description**: Issues immutable correction adjustments.
\n– InvoiceTypeCode `381`: Credit Note (Full\/Partial reversals referencing original parent IRN codes)
\n– InvoiceTypeCode `383`: Debit Note (Additional adjustments)<\/p>\n

 <\/p>\n

## 3. Local Cryptographic Hashing Protocol<\/strong>
\nTo safeguard offline operability and system speed, the platform encodes the verification QR code string values on the fly within the local runtime scope:
\n1. Concatenates the registered unique `IRN` code with a current UNIX timestamp: `{IRN}.{TIMESTAMP}`
\n2. Encrypts the raw string package using local RSA-PKCS1 public-key encryption.
\n3. Base64-encodes the ciphertext output payload. This string variable dynamically populates the high-density print QR code element inside the customer invoice template layouts.<\/p>\n","protected":false},"excerpt":{"rendered":"

# Profitaa ERP \u2014 Federal Inland Revenue Service (FIRS) MBS API Integration   Welcome to the Profitaa integration specs. This reference outlines how multi-tenant business nodes programmatically interact with the Merchant Buyer Solution (MBS) core ledger for real-time electronic invoice pre-clearance and cryptographic validation.   ## 1. Protocol Architecture – **Transport**: HTTPS POST over TLS […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[99],"doc_tag":[],"class_list":["post-7331","docs","type-docs","status-publish","hentry","doc_category-integration"],"year_month":"2026-10","word_count":276,"total_views":"2","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Profitaa","author_nicename":"profitaa","author_url":"https:\/\/profitaa.com\/ng\/author\/profitaa\/"},"doc_category_info":[{"term_name":"Integration","term_url":"https:\/\/profitaa.com\/ng\/docs-category\/integration\/"}],"doc_tag_info":[],"yoast_head":"\nNRS MBS API Documentation - Profitaa<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"NRS MBS API Documentation - Profitaa\" \/>\n<meta property=\"og:description\" content=\"# Profitaa ERP \u2014 Federal Inland Revenue Service (FIRS) MBS API Integration   Welcome to the Profitaa integration specs. This reference outlines how multi-tenant business nodes programmatically interact with the Merchant Buyer Solution (MBS) core ledger for real-time electronic invoice pre-clearance and cryptographic validation.   ## 1. Protocol Architecture – **Transport**: HTTPS POST over TLS […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/\" \/>\n<meta property=\"og:site_name\" content=\"Profitaa\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/facebook.com\/profitaahq\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-07T10:05:14+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@profitaahq\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/integration\\\/nrs-mbs-api-documentation\\\/\",\"url\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/integration\\\/nrs-mbs-api-documentation\\\/\",\"name\":\"NRS MBS API Documentation - Profitaa\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#website\"},\"datePublished\":\"2026-10-07T10:03:27+00:00\",\"dateModified\":\"2026-10-07T10:05:14+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/integration\\\/nrs-mbs-api-documentation\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/integration\\\/nrs-mbs-api-documentation\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/integration\\\/nrs-mbs-api-documentation\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Help & Documentations\",\"item\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/help\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"NRS MBS API Documentation\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#website\",\"url\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/\",\"name\":\"Profitaa\",\"description\":\"Agentic Business Operating System\",\"publisher\":{\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#organization\",\"name\":\"Profitaa Limited\",\"url\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/profitaa.com\\\/wp-content\\\/uploads\\\/2025\\\/09\\\/MAINLOGO_PROFITAA.png\",\"contentUrl\":\"https:\\\/\\\/profitaa.com\\\/wp-content\\\/uploads\\\/2025\\\/09\\\/MAINLOGO_PROFITAA.png\",\"width\":1710,\"height\":1514,\"caption\":\"Profitaa Limited\"},\"image\":{\"@id\":\"https:\\\/\\\/profitaa.com\\\/ng\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/facebook.com\\\/profitaahq\",\"https:\\\/\\\/x.com\\\/profitaahq\",\"https:\\\/\\\/instagram.com\\\/profitaahq\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/105135508\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"NRS MBS API Documentation - Profitaa","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/","og_locale":"en_US","og_type":"article","og_title":"NRS MBS API Documentation - Profitaa","og_description":"# Profitaa ERP \u2014 Federal Inland Revenue Service (FIRS) MBS API Integration   Welcome to the Profitaa integration specs. This reference outlines how multi-tenant business nodes programmatically interact with the Merchant Buyer Solution (MBS) core ledger for real-time electronic invoice pre-clearance and cryptographic validation.   ## 1. Protocol Architecture – **Transport**: HTTPS POST over TLS […]","og_url":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/","og_site_name":"Profitaa","article_publisher":"https:\/\/facebook.com\/profitaahq","article_modified_time":"2026-10-07T10:05:14+00:00","twitter_card":"summary_large_image","twitter_site":"@profitaahq","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/","url":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/","name":"NRS MBS API Documentation - Profitaa","isPartOf":{"@id":"https:\/\/profitaa.com\/ng\/#website"},"datePublished":"2026-10-07T10:03:27+00:00","dateModified":"2026-10-07T10:05:14+00:00","breadcrumb":{"@id":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/profitaa.com\/ng\/help\/integration\/nrs-mbs-api-documentation\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/profitaa.com\/ng\/"},{"@type":"ListItem","position":2,"name":"Help & Documentations","item":"https:\/\/profitaa.com\/ng\/help\/"},{"@type":"ListItem","position":3,"name":"NRS MBS API Documentation"}]},{"@type":"WebSite","@id":"https:\/\/profitaa.com\/ng\/#website","url":"https:\/\/profitaa.com\/ng\/","name":"Profitaa","description":"Agentic Business Operating System","publisher":{"@id":"https:\/\/profitaa.com\/ng\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/profitaa.com\/ng\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/profitaa.com\/ng\/#organization","name":"Profitaa Limited","url":"https:\/\/profitaa.com\/ng\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/profitaa.com\/ng\/#\/schema\/logo\/image\/","url":"https:\/\/profitaa.com\/wp-content\/uploads\/2025\/09\/MAINLOGO_PROFITAA.png","contentUrl":"https:\/\/profitaa.com\/wp-content\/uploads\/2025\/09\/MAINLOGO_PROFITAA.png","width":1710,"height":1514,"caption":"Profitaa Limited"},"image":{"@id":"https:\/\/profitaa.com\/ng\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/facebook.com\/profitaahq","https:\/\/x.com\/profitaahq","https:\/\/instagram.com\/profitaahq","https:\/\/www.linkedin.com\/company\/105135508\/"]}]}},"_links":{"self":[{"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/docs\/7331","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/comments?post=7331"}],"version-history":[{"count":3,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/docs\/7331\/revisions"}],"predecessor-version":[{"id":7334,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/docs\/7331\/revisions\/7334"}],"wp:attachment":[{"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/media?parent=7331"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/doc_category?post=7331"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/profitaa.com\/ng\/wp-json\/wp\/v2\/doc_tag?post=7331"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}