{
  "info": {
    "name": "EFRIS API — Uganda URA",
    "description": "Every URA EFRIS interface (T101-T187) exposed as a single REST API.\n\n## Setup\n\nSet two collection variables:\n\n| Variable | What it is |\n|---|---|\n| `base_url` | Where the platform runs, e.g. `https://efris.example.com` |\n| `api_key` | Your API key, sent as the `X-API-Key` header |\n\n## Start here\n\n`GET /api/external/efris/server-time` is the lightest call and confirms your\ncertificate and TIN are accepted. If it works and something else fails, the\nproblem is the document rather than the credentials - which separates the two\nmost common first-day failures.\n\n## When URA rejects something\n\nRejections carry a numeric code. Branch on the number, never the message text:\nURA rewords messages between releases and some come back in mixed language.\n\nWhat each code means, and how to fix it: https://efrisapi.com/docs/errors/\n\nThe summary block causes most first rejections - `netAmount` must equal\n`grossAmount` minus `taxAmount` (1343), `taxAmount` must include excise (1344)\nwhile `grossAmount` must exclude it (1345), and `itemCount` must exclude\ndiscount lines (1304).\n\n---\n\nPowered by the EFRIS Integration Platform - https://efrisapi.com\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://efris.example.com",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "1. invoices & credit notes",
      "item": [
        {
          "name": "External batch upload invoices",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/batch-invoice-upload",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "batch-invoice-upload"
              ]
            },
            "description": "Batch Invoice Upload (T129)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External cancel credit note application",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/cancel-credit-note",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "cancel-credit-note"
              ]
            },
            "description": "Cancel of credit/debit note application (T114)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query cancel credit note details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/cancel-credit-note-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "cancel-credit-note-details"
              ],
              "query": [
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query cancel credit note details (T122)"
          },
          "response": []
        },
        {
          "name": "External query credit note application details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/credit-note-application-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "credit-note-application-details"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query Credit Note Application and Cancel of Debit Note Application Details (T118)"
          },
          "response": []
        },
        {
          "name": "External approve credit note application",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/credit-note-approval",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "credit-note-approval"
              ]
            },
            "description": "credit application approval (T113)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query credit notes",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/credit-notes?queryType=1&pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "credit-notes"
              ],
              "query": [
                {
                  "key": "referenceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "oriInvoiceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "approveStatus",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "queryType",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Query credit notes using EFRIS (T112)"
          },
          "response": []
        },
        {
          "name": "External query creditable invoices",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/creditable-invoices?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "creditable-invoices"
              ],
              "query": [
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                },
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "deviceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "buyerTin",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "buyerLegalName",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "invoiceType",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "branchName",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Apply for invoice inquiry (T107)"
          },
          "response": []
        },
        {
          "name": "External query export invoice status",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/export-invoice-status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "export-invoice-status"
              ],
              "query": [
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Export Invoice Status Query (T187)"
          },
          "response": []
        },
        {
          "name": "External check invoices",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/invoice-checks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "invoice-checks"
              ]
            },
            "description": "Invoice Checks (T117)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query invoice remain details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/invoice-remain-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "invoice-remain-details"
              ],
              "query": [
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Invoice Remain details (T186)"
          },
          "response": []
        },
        {
          "name": "External get invoice",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/invoice/{invoice_number}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "invoice",
                ":invoice_number"
              ]
            },
            "description": "Query invoice status from activity logs (gateway style)"
          },
          "response": []
        },
        {
          "name": "External list invoices",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/invoices?limit=50&offset=0",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "invoices"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "disabled": false
                },
                {
                  "key": "offset",
                  "value": "0",
                  "disabled": false
                },
                {
                  "key": "status",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "List recent invoices from activity logs (gateway style)"
          },
          "response": []
        },
        {
          "name": "External submit credit note",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/submit-credit-note",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "submit-credit-note"
              ]
            },
            "description": "Submit credit note application to EFRIS (T110 - Credit Note Application)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External submit invoice",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/submit-invoice",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "submit-invoice"
              ]
            },
            "description": "Submit invoice to EFRIS and get complete fiscal invoice data",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External update buyer details",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/update-buyer-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "update-buyer-details"
              ]
            },
            "description": "Update buyer details (T166)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External void credit debit note application",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/void-credit-debit-note-application",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "void-credit-debit-note-application"
              ]
            },
            "description": "Void Credit Debit/Note Application (T120)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External upload z report",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/z-report",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "z-report"
              ]
            },
            "description": "Z-report Daily Upload (T116)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "2. goods & stock",
      "item": [
        {
          "name": "External query branch stock records",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/branch-stock-records?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "branch-stock-records"
              ],
              "query": [
                {
                  "key": "combineKeywords",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "stockInType",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "supplierTin",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "supplierName",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Goods Stock recods query - current branch (T147)"
          },
          "response": []
        },
        {
          "name": "External query goods",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/goods",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "goods"
              ],
              "query": [
                {
                  "key": "goods_code",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "goods_name",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "search",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "service_only",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query ALL registered goods and services for a taxpayer from EFRIS (T127)"
          },
          "response": []
        },
        {
          "name": "External query goods by code",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/goods-by-code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "goods-by-code"
              ],
              "query": [
                {
                  "key": "goodsCode",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "tin",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Goods/Services Inquiry by goods Code (T144)"
          },
          "response": []
        },
        {
          "name": "External query goods stock quantity",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/goods-stock-quantity",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "goods-stock-quantity"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "branchId",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query the stock quantity by goods id (T128)"
          },
          "response": []
        },
        {
          "name": "External register product",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/register-product",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "register-product"
              ]
            },
            "description": "Register a product/item with EFRIS (T130)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query stock adjust detail",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-adjust-detail",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-adjust-detail"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Goods Stock Adjust detail query (T160)"
          },
          "response": []
        },
        {
          "name": "External query stock adjust records",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-adjust-records?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-adjust-records"
              ],
              "query": [
                {
                  "key": "referenceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Goods Stock Adjust recods query (T149)"
          },
          "response": []
        },
        {
          "name": "External stock decrease",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-decrease",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-decrease"
              ]
            },
            "description": "External API endpoint for custom ERP systems to decrease stock in EFRIS",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External stock increase",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-increase",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-increase"
              ]
            },
            "description": "Increase stock in EFRIS (T131) - External System Format",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query goods stock record detail",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-record-detail",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-record-detail"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Goods Stock recods detail query (T148)"
          },
          "response": []
        },
        {
          "name": "External query goods stock records",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-records?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-records"
              ],
              "query": [
                {
                  "key": "productionBatchNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "referenceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Goods Stock recods query (T145)"
          },
          "response": []
        },
        {
          "name": "External stock transfer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-transfer",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-transfer"
              ]
            },
            "description": "Transfer stock between branches in EFRIS (T139 - Goods Stock Transfer).",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query stock transfer detail",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-transfer-detail",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-transfer-detail"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Goods Stock Transfer detail query (T184)"
          },
          "response": []
        },
        {
          "name": "External query stock transfer records",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/stock-transfers?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "stock-transfers"
              ],
              "query": [
                {
                  "key": "referenceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "sourceBranchId",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "destinationBranchId",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Goods Stock Transfer records query (T183)"
          },
          "response": []
        },
        {
          "name": "External submit purchase order",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/submit-purchase-order",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "submit-purchase-order"
              ]
            },
            "description": "Submit purchase order to EFRIS (T130 - Send Purchase Order)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "3. reference data",
      "item": [
        {
          "name": "External query agent relations",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/agent-relations",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "agent-relations"
              ],
              "query": [
                {
                  "key": "tin",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query agent relation information (T179)"
          },
          "response": []
        },
        {
          "name": "External get all branches",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/branches",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "branches"
              ]
            },
            "description": "Get all branches for the taxpayer (T138)"
          },
          "response": []
        },
        {
          "name": "External query category excise by date",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/category-excise-by-date?type=1",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "category-excise-by-date"
              ],
              "query": [
                {
                  "key": "categoryCode",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "issueDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "1",
                  "disabled": false
                }
              ]
            },
            "description": "Query Commodity Category /Excise Duty by issueDate (T146)"
          },
          "response": []
        },
        {
          "name": "External query commodity categories",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/commodity-categories?pageNo=1&pageSize=10",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "commodity-categories"
              ],
              "query": [
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                }
              ]
            },
            "description": "Query EFRIS commodity categories with pagination (T124)"
          },
          "response": []
        },
        {
          "name": "External query commodity category list",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/commodity-category-list",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "commodity-category-list"
              ]
            },
            "description": "Query Commodity Category (T123)"
          },
          "response": []
        },
        {
          "name": "External query commodity category updates",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/commodity-category-updates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "commodity-category-updates"
              ],
              "query": [
                {
                  "key": "commodityCategoryVersion",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Commodity category incremental update (T134)"
          },
          "response": []
        },
        {
          "name": "External get exchange rate",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/exchange-rate",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "exchange-rate"
              ],
              "query": [
                {
                  "key": "currency",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "issueDate",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Acquiring exchange rate (T121)"
          },
          "response": []
        },
        {
          "name": "External get all exchange rates",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/exchange-rates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "exchange-rates"
              ],
              "query": [
                {
                  "key": "issueDate",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Get all exchange rates (T126)"
          },
          "response": []
        },
        {
          "name": "External get excise duty",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/excise-duty",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "excise-duty"
              ],
              "query": [
                {
                  "key": "excise_code",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "excise_name",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "External API endpoint for custom ERP systems to fetch excise duty codes from EFRIS"
          },
          "response": []
        },
        {
          "name": "External get frequent contacts",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/frequent-contacts",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "frequent-contacts"
              ],
              "query": [
                {
                  "key": "buyerTin",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "buyerLegalName",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Get Frequent Contacts (T182)"
          },
          "response": []
        },
        {
          "name": "External query hs code list",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/hs-codes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "hs-codes"
              ]
            },
            "description": "Query HS Code List (T185)"
          },
          "response": []
        },
        {
          "name": "External query principal agent",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/principal-agent",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "principal-agent"
              ],
              "query": [
                {
                  "key": "tin",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "branchId",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query Principal agent TIN information (T180)"
          },
          "response": []
        },
        {
          "name": "External check exempt deemed taxpayer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/taxpayer-exempt-status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "taxpayer-exempt-status"
              ],
              "query": [
                {
                  "key": "tin",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "commodityCategoryCode",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Check exempt/Deemed taxpayer (T137)"
          },
          "response": []
        },
        {
          "name": "External query taxpayer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/taxpayer/{tin}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "taxpayer",
                ":tin"
              ]
            },
            "description": "Query taxpayer information by TIN from URA EFRIS (T119)"
          },
          "response": []
        },
        {
          "name": "External get units of measure",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/units-of-measure",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "units-of-measure"
              ]
            },
            "description": "Get EFRIS Units of Measure codes - Maps ERP units to EFRIS codes"
          },
          "response": []
        },
        {
          "name": "External upload frequent contact",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/upload-frequent-contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "upload-frequent-contact"
              ]
            },
            "description": "Upload Frequent Contacts (T181)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "4. fuel / EDC",
      "item": [
        {
          "name": "External query edc device versions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/edc-device-versions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "edc-device-versions"
              ]
            },
            "description": "Query Edc device Version (T173)"
          },
          "response": []
        },
        {
          "name": "External upload edc disconnections",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/edc-disconnections",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "edc-disconnections"
              ]
            },
            "description": "Upload EDC disconnection data (T164)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query edc invoices",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/edc-invoices?pageNo=1&pageSize=10&queryType=3",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "edc-invoices"
              ],
              "query": [
                {
                  "key": "pageNo",
                  "value": "1",
                  "disabled": false
                },
                {
                  "key": "pageSize",
                  "value": "10",
                  "disabled": false
                },
                {
                  "key": "queryType",
                  "value": "3",
                  "disabled": false
                },
                {
                  "key": "fuelType",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "invoiceNo",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "buyerLegalName",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "branchId",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "EDC Invoice /Receipt inquiry (T167)"
          },
          "response": []
        },
        {
          "name": "External query edc uom exchange rates",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/edc-uom-exchange-rates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "edc-uom-exchange-rates"
              ]
            },
            "description": "Query EDC UoM exchange rate (T171)"
          },
          "response": []
        },
        {
          "name": "External upload fuel nozzle status",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/fuel-nozzle-status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "fuel-nozzle-status"
              ]
            },
            "description": "Fuel nozzle status upload (T172)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query fuel pump details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/fuel-pump-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "fuel-pump-details"
              ],
              "query": [
                {
                  "key": "id",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query fuel pump, fuel nozzle, fuel tank according to pump no (T169)"
          },
          "response": []
        },
        {
          "name": "External query fuel pump versions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/fuel-pump-versions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "fuel-pump-versions"
              ]
            },
            "description": "Query fuel pump version (T168)"
          },
          "response": []
        },
        {
          "name": "External upload fuel shift",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/fuel-shifts",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "fuel-shifts"
              ]
            },
            "description": "Upload shift information (T163)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query fuel types",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/fuel-types",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "fuel-types"
              ]
            },
            "description": "Query fuel type (T162)"
          },
          "response": []
        }
      ]
    },
    {
      "name": "5. device & system",
      "item": [
        {
          "name": "External upload certificate public key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/certificate-public-key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "certificate-public-key"
              ]
            },
            "description": "Certificate public key upload (T136)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External initialize client",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/client-initialization",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "client-initialization"
              ],
              "query": [
                {
                  "key": "otp",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Client initialization (T102)"
          },
          "response": []
        },
        {
          "name": "External upload device issuing status",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/device-issuing-status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "device-issuing-status"
              ]
            },
            "description": "Upload device issuing status (T176)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External diagnostic test",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/diagnostic-test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "diagnostic-test"
              ]
            },
            "description": "Perform diagnostic self-test of EFRIS connectivity for this company"
          },
          "response": []
        },
        {
          "name": "External query efd location",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/efd-location",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "efd-location"
              ],
              "query": [
                {
                  "key": "deviceNumber",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "startDate",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "endDate",
                  "value": "",
                  "disabled": true
                }
              ]
            },
            "description": "Query efd location (T170)"
          },
          "response": []
        },
        {
          "name": "External efd transfer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/efd-transfer",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "efd-transfer"
              ]
            },
            "description": "EFD Transfer (T178)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External upload exception log",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/exception-logs",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "exception-logs"
              ]
            },
            "description": "Upload exception log (T132)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External reset forgotten password",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/forgot-password",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "forgot-password"
              ]
            },
            "description": "forget password (T105)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External query negative stock configuration",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/negative-stock-configuration",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "negative-stock-configuration"
              ]
            },
            "description": "Negative stock configuration inquiry (T177)"
          },
          "response": []
        },
        {
          "name": "External passthrough",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/passthrough/{interface_code}?encrypt_code=1",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "passthrough",
                ":interface_code"
              ],
              "query": [
                {
                  "key": "encrypt_code",
                  "value": "1",
                  "disabled": false
                }
              ]
            },
            "description": "Generic passthrough endpoint to execute any URA EFRIS request.",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        },
        {
          "name": "External get registration details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/registration-details",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "registration-details"
              ]
            },
            "description": "Get taxpayer profile and registration details from EFRIS (T102)"
          },
          "response": []
        },
        {
          "name": "External get server time",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/server-time",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "server-time"
              ]
            },
            "description": "Get current server time from EFRIS (T101)"
          },
          "response": []
        },
        {
          "name": "External get tcs latest version",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/tcs-latest-version",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "tcs-latest-version"
              ]
            },
            "description": "Get Tcs Latest Version (T135)"
          },
          "response": []
        },
        {
          "name": "External download tcs upgrade files",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/external/efris/tcs-upgrade-files?osType=1",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "tcs-upgrade-files"
              ],
              "query": [
                {
                  "key": "tcsVersion",
                  "value": "",
                  "disabled": true
                },
                {
                  "key": "osType",
                  "value": "1",
                  "disabled": false
                }
              ]
            },
            "description": "TCS upgrade system file download (T133)"
          },
          "response": []
        },
        {
          "name": "External create ussd taxpayer account",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/external/efris/ussd-taxpayer-account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "external",
                "efris",
                "ussd-taxpayer-account"
              ]
            },
            "description": "Account Creation for USSD taxpayer (T175)",
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \n}"
            }
          },
          "response": []
        }
      ]
    }
  ]
}