Upload the issuer's logo
Replaces the previous logo. It appears on the issuer's portal, on the RIDE and in the emails to its customers. PNG or JPEG, up to 512 KB: the format is read from the file, not from its name.
AuthorizationBearer <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.
id*stringuuidFiscalbase-Environment?stringThe 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.
"sandbox""test""live"Fiscalbase-Business?stringThe 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.
uuidFiscalbase-Channel?stringWhich 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.
"api""mcp"Fiscalbase-Agent?stringThe 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.
multipart/form-data- body
file*fileThe logo, as PNG or JPEG, up to 512 KB.
binaryThe business
application/json- response
id*stringuuidobject*"business""business"kind*stringsandbox: a practice business, with made-up data and the practice RUC 9999999999001; it issues only in sandbox, is free and can be deleted. live: a real RUC; it issues in test and live, is paid and cannot be deleted. Chosen on creation and never changes.
"sandbox""live"country*"ec"The country, as its lowercase ISO 3166-1 alpha-2 code, the same as in the path (/v1/ec/…). New countries may appear.
"ec"ruc*stringlegal_name*stringtrade_name*string|nullhead_office_address*stringhead_office_phone*string|nullhead_office_email*string|nullreply_to_email*string|nullfooter_legend*string|nullkeeps_accounting*booleanregime*string"general""rimpe_emprendedor""rimpe_negocio_popular"special_taxpayer_resolution*string|nullwithholding_agent_resolution*string|nulllarge_taxpayer_resolution*string|nullcertificate*|The certificate that signs test and live documents: the most recent one you uploaded, while it is still valid; null if it is missing or expired, and then nothing is issued in test or live, even if an earlier one is still valid.
issuing*portal*What the business set about how its portal looks, each setting null while it sets nothing (the portal's default). The business keeps what it set when it moves to a plan without portal branding.
logo*|The issuer's logo, shown on its portal, on the RIDE and in the emails to its customers.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X PUT 'https://api.fiscalbase.io/v1/ec/businesses/497f6eca-6276-4993-bfeb-53cbbbba6f08/logo' \
-F 'file=string'{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"object": "business",
"kind": "sandbox",
"country": "ec",
"ruc": "string",
"legal_name": "string",
"trade_name": "string",
"head_office_address": "string",
"head_office_phone": "string",
"head_office_email": "string",
"reply_to_email": "string",
"footer_legend": "string",
"keeps_accounting": true,
"regime": "general",
"special_taxpayer_resolution": "string",
"withholding_agent_resolution": "string",
"large_taxpayer_resolution": "string",
"certificate": {
"holder": "string",
"holder_identification": "string",
"holder_identification_type": "cedula",
"kind": "natural_person",
"issuer_name": "string",
"subject": "string",
"issuer": "string",
"serial_number": "string",
"valid_from": "2019-08-24T14:15:22Z",
"valid_until": "2019-08-24T14:15:22Z"
},
"issuing": {
"allowed": true,
"lock": {
"code": "plan_required",
"message": "string",
"canceled": true,
"trial_ended": true
},
"state": "off",
"active_since": "2019-08-24T14:15:22Z"
},
"portal": {
"brand_color": "string",
"title_font": "sora",
"corners": "square",
"layout": "split",
"cover": "brand",
"cover_url": "http://example.com",
"heading": "string",
"lead": "string",
"tagline": "string",
"top_bar": "white",
"whatsapp": "string",
"website": "string"
},
"logo": {
"url": "http://example.com",
"content_type": "image/png",
"size": 0
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}Read an invoice from the SRI GET
Asks the SRI for an invoice addressed to anyone, including one whose annulment is pending, and reads it without storing it: enough to issue a withholding on it. A `test` key asks the SRI's testing service and a `live` key its real one; the access key must belong to the same environment. The SRI only answers for documents from the last 60 days. `sandbox` never asks it: its practice SRI answers for the practice business's received invoices (keyed `ambiente 1`), and any other key is not found. An answer may be kept for a minute (`Cache-Control`). To keep a document in your records, upload its XML or the SRI's report with `POST /v1/ec/imports`.
Remove the issuer's logo DELETE
The portal, the RIDE and emails go back to showing only its name.