<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: BillOS</title>
    <description>The latest articles on DEV Community by BillOS (@billos_app_3d708b28bbceea).</description>
    <link>https://dev.to/billos_app_3d708b28bbceea</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4240855%2F4385b5cb-5097-4d71-b4aa-17ff0349dd17.png</url>
      <title>DEV Community: BillOS</title>
      <link>https://dev.to/billos_app_3d708b28bbceea</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/billos_app_3d708b28bbceea"/>
    <language>en</language>
    <item>
      <title>Issuing an Israeli tax invoice from code: allocation numbers, a registered ledger and an MCP server</title>
      <dc:creator>BillOS</dc:creator>
      <pubDate>Thu, 12 Nov 2026 11:07:56 +0000</pubDate>
      <link>https://dev.to/billos_app_3d708b28bbceea/issuing-an-israeli-tax-invoice-from-code-allocation-numbers-a-registered-ledger-and-an-mcp-server-22da</link>
      <guid>https://dev.to/billos_app_3d708b28bbceea/issuing-an-israeli-tax-invoice-from-code-allocation-numbers-a-registered-ledger-and-an-mcp-server-22da</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;Disclosure: I'm on the team building BillOS.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;If you build software for Israeli businesses, sooner or later someone asks you to "just send the invoice from the app". In Israel that is more than a PDF:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A tax invoice has to come from software &lt;strong&gt;registered with the Israel Tax Authority&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;Numbering has to be &lt;strong&gt;gapless&lt;/strong&gt; per document type.&lt;/li&gt;
&lt;li&gt;An issued document can &lt;strong&gt;never be edited&lt;/strong&gt;. You correct it with a credit note.&lt;/li&gt;
&lt;li&gt;Since June 2026, a tax invoice above &lt;strong&gt;₪5,000 before VAT&lt;/strong&gt; needs an &lt;strong&gt;allocation number&lt;/strong&gt; (מספר הקצאה) from the Tax Authority, or the customer cannot deduct the VAT on it.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;We built &lt;a href="https://billos.co.il/en/" rel="noopener noreferrer"&gt;BillOS&lt;/a&gt; so that all of this is one API call.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the API gives you
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;REST + JSON at &lt;code&gt;https://api.billos.co.il/v1&lt;/code&gt;, described by an OpenAPI 3.1 file.&lt;/li&gt;
&lt;li&gt;Auth with an &lt;code&gt;X-Api-Key&lt;/code&gt; header, or OAuth 2.0 with PKCE when your app acts for a business that connected it.&lt;/li&gt;
&lt;li&gt;Signed webhooks (HMAC-SHA256) with retries and an event log.&lt;/li&gt;
&lt;li&gt;SDKs: &lt;a href="https://www.npmjs.com/package/billos-sdk" rel="noopener noreferrer"&gt;&lt;code&gt;billos-sdk&lt;/code&gt;&lt;/a&gt; on npm, &lt;a href="https://pypi.org/project/billos/" rel="noopener noreferrer"&gt;&lt;code&gt;billos&lt;/code&gt;&lt;/a&gt; on PyPI, and a &lt;code&gt;billos&lt;/code&gt; CLI.&lt;/li&gt;
&lt;li&gt;A hosted &lt;strong&gt;MCP server&lt;/strong&gt;, listed in the official MCP Registry as &lt;code&gt;il.co.billos/billos&lt;/code&gt;, so an AI agent can issue and look up documents.&lt;/li&gt;
&lt;li&gt;A free, self-serve &lt;strong&gt;sandbox&lt;/strong&gt; in a separate database.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Getting a sandbox key in a minute
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx billos sandbox
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It prints a link. You sign in with Google, approve once, and a &lt;code&gt;bk_test_&lt;/code&gt; key arrives in the terminal. An agent can ask for its own key the same way, with a person approving it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why the hard parts live in the ledger, not in your code
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Documents are immutable once issued.&lt;/strong&gt; A mistake is corrected with a credit note that names the invoice it corrects.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Numbering is gapless&lt;/strong&gt; per document type, so you never manage counters.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Money is integer agorot&lt;/strong&gt; (₪1 = 100), never floats.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Allocation numbers are requested automatically&lt;/strong&gt; above the threshold (on the paid plans).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Retries are safe&lt;/strong&gt;: pass an idempotency key and a timed-out request never becomes two documents.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  For AI agents
&lt;/h2&gt;

&lt;p&gt;Point any MCP client at &lt;code&gt;https://api.billos.co.il/mcp&lt;/code&gt; with your key in &lt;code&gt;X-Api-Key&lt;/code&gt;. Tools cover businesses, documents (with a &lt;code&gt;dryRun&lt;/code&gt; before anything permanent), customers, open balances, expenses and a financial summary.&lt;/p&gt;

&lt;h2&gt;
  
  
  Links
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Developer docs and examples (Express, Next.js, Flask): &lt;a href="https://dev.billos.co.il" rel="noopener noreferrer"&gt;dev.billos.co.il&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Agent kit: &lt;a href="https://github.com/billos-dev/billos" rel="noopener noreferrer"&gt;github.com/billos-dev/billos&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;Product (Hebrew): &lt;a href="https://billos.co.il" rel="noopener noreferrer"&gt;billos.co.il&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Questions about Israeli invoicing rules or the design of the ledger are welcome in the comments.&lt;/p&gt;

</description>
      <category>api</category>
      <category>fintech</category>
      <category>mcp</category>
      <category>javascript</category>
    </item>
  </channel>
</rss>
