Skip to Content

Open a punto

POST
/v1/ec/issuing-points

Where a live business issues: its invoice and withholding series at one punto in live, opened in one transaction, or kept where Fiscalbase already issues them. The establishment must be listed as open for the RUC in the SRI registry; its address comes from there. A punto another system used in the last 24 months is 409 series_used_elsewhere unless continuing takes its numbering over, as POST /v1/ec/series/{id}/continue does. A practice business issues in sandbox only (422 business_issues_in_sandbox_only). Any refusal changes nothing. Send an Idempotency-Key to retry safely.

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.

Header Parameters

idempotency-key?string

Send the same key to retry safely: a repeat of the same request answers what the first answered, without doing it again. Keys are scoped to your key's business and environment; the same key with another request is 409 idempotency_key_reused.

Length1 <= length <= 255
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.

Request Body

application/json
  1. body
establishment*string
Match^\d{3}$
emission_point*string
Match^\d{3}$
continuing?boolean
Defaultfalse

Response Body

The punto

application/json
  1. response
object*"issuing_point"
Value in"issuing_point"
establishment*string
Match^\d{3}$
emission_point*string
Match^\d{3}$
series*array<>

Its series. Opening a punto answers the invoice and withholding series it opened or kept, in live; reading one answers every series of the punto in your key's environment.

Example Request
curl -X POST 'https://api.fiscalbase.io/v1/ec/issuing-points' \
  -H 'Content-Type: application/json' \
  -d '{
  "establishment": "string",
  "emission_point": "string"
}'
Example Response
{
  "object": "issuing_point",
  "establishment": "string",
  "emission_point": "string",
  "series": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "object": "series",
      "business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c",
      "environment": "sandbox",
      "type": "invoice",
      "establishment": "string",
      "emission_point": "string",
      "establishment_address": "string",
      "establishment_name": "string",
      "emission_point_name": "string",
      "issued_by": "fiscalbase",
      "active": true,
      "next_number": 1,
      "last_number_seen": 0,
      "last_seen_on": "2019-08-24",
      "seen_this_month": 0,
      "issued_today": 0,
      "gaps": {
        "count": 0,
        "oldest_missing": 0
      },
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}