Skip to Content

Where to issue

GET
/v1/ec/series/suggestion

The punto to issue a type from: one where Fiscalbase already issues it, else the head office (or the lowest open establishment the SRI registry lists) and its lowest emission point no other system used in the last 24 months, so its numbers never collide with another system's (the SRI's error 45).

Authorization

headerAuthorizationBearer <token>

Your API key, which acts for the one business it was created for: fb_live_… keys work at api.fiscalbase.io and issue in live, and fb_sandbox_… keys work at api-sandbox.fiscalbase.io and issue in sandbox, on the simulated SRI. A key sent to the other host is refused with api_key_wrong_host, which names its host.

Query Parameters

type*string
Value in"invoice""credit_note""debit_note""withholding""delivery_note""purchase_settlement"

Header Parameters

Fiscalbase-Environment?string

The environment the call acts in. Required with a person's session; a key's own environment is the one that counts, so a key may leave it out, and naming another is 422 environment_mismatch.

Value in"sandbox""test""live"
Fiscalbase-Business?string

The business the call acts for. With a person's session, the one the call is about (without it, a call about one business is 422 business_required and a list covers every business of the organization); a key acts for its own, so naming another is 422 business_mismatch.

Formatuuid
Fiscalbase-Channel?string

Which of Fiscalbase's own integrations a key's call comes from, recorded as the channel of the documents it issues: a record, not a permission. Without it, api. A person's call is always console.

Value in"api""mcp"
Fiscalbase-Agent?string

The AI agent a key's call comes from, as its client names itself (the MCP server sets it); recorded with the request and shown in the console's request log.

Response Body

The punto

application/json
  1. response
object*"series_suggestion"
Value in"series_suggestion"
type*string
Value in"invoice""credit_note""debit_note""withholding""delivery_note""purchase_settlement"
establishment*string
emission_point*string
establishment_address*string|null
existing*boolean

Whether Fiscalbase already issues this type there.

Example Request
curl -X GET 'https://api.fiscalbase.io/v1/ec/series/suggestion?type=invoice'
Example Response
{
  "object": "series_suggestion",
  "type": "invoice",
  "establishment": "string",
  "emission_point": "string",
  "establishment_address": "string",
  "existing": true
}