FastBill MCP by usefulapi
Read FastBill customers, invoices, estimates, expenses; create customers, invoices, projects.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (1)
- LOWTool 'fastbill_list_recurring_invoices' name length outside 3-30 rangeen fastbill_list_recurring_invoices
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~6,781Tokens (definiciones de herramientas)
~2.7 KBTamaño de respuesta típico
Impacto significativo en la atención (5.30% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"fastbill": {
"url": "https://fastbill.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://fastbill.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (22)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢fastbill_list_customers(term, customer_number, country_code, city, limit, ...)
List customers (name, address, e-mail, VAT id, payment terms and bank details as stored in FastBill). Filter by search term (organization, name, address, zip, e-mail or tags), customer number, country or city. customer.get.
Esquema de entrada
{
"type": "object",
"properties": {
"term": {
"description": "Search term matched against organization, first/last name, address, zip code, e-mail and tags.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"customer_number": {
"description": "Exact customer number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country_code": {
"description": "ISO 3166 alpha-2 country code, e.g. DE.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_get_customer(customer_id)
One customer by FastBill customer id. customer.get with CUSTOMER_ID.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill customer id."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_contacts(customer_id, customer_number, term, contact_id, limit, ...)
List contact persons of customers (name, position, e-mail, phone). Filter by customer, search term or contact id. contact.get.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"description": "Only contacts of this customer id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"customer_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"term": {
"description": "Search term matched against organization, name, address, zip code, e-mail and tags.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contact_id": {
"description": "One contact id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_invoices(customer_id, invoice_number, type, start_date, end_date, ...)
List outgoing invoices, drafts and credit notes with totals, state (draft, unpaid, overdue, paid, canceled), dates and line items. Filter by customer, number, type, date ranges (invoice date, due date, paid date, last update). invoice.get.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"invoice_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"type": {
"description": "outgoing = finalized invoice, draft, credit = credit note.",
"type": "string",
"enum": [
"outgoing",
"draft",
"credit"
]
},
"start_date": {
"description": "Invoices dated on or after this day.",
"type": "string"
},
"end_date": {
"description": "Invoices dated up to this day.",
"type": "string"
},
"start_due_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_due_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"start_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"start_lastupdate": {
"description": "Changed on or after this day.",
"type": "string"
},
"end_lastupdate": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_get_invoice(invoice_id)
One invoice by FastBill invoice id, with all line items, VAT, payments and the document URL. invoice.get with INVOICE_ID.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill invoice id."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_recurring_invoices(invoice_id, limit, offset)
List recurring invoice templates (customer, interval data, totals, items). recurring.get.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"description": "One recurring invoice id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_estimates(customer_id, estimate_id, estimate_number, start_date, end_date, ...)
List estimates (quotes) with state (a created, b sent, c negotiation, d accepted, e rejected, f invoiced), totals and items. estimate.get.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"estimate_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"estimate_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"start_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_expenses(invoice_id, invoice_number, start_date, end_date, start_paid_date, ...)
List expense entries (supplier, category, net/VAT/gross, dates, document URL). Filter by invoice number or date ranges. expense.get.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"invoice_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"start_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"start_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_revenues(customer_id, invoice_number, start_date, end_date, start_paid_date, ...)
List revenue entries (income booked in FastBill: customer, totals, dates, payments). Takes the same filters as invoices. revenue.get.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"invoice_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"start_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"start_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_paid_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_articles(article_id, article_number, limit, offset)
List products and services (article number, type, title, unit price, VAT, unit). article.get.
Esquema de entrada
{
"type": "object",
"properties": {
"article_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"article_number": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_projects(project_id, customer_id, limit, offset)
List projects (name, customer, hourly rate, VAT, start/end date). project.get.
Esquema de entrada
{
"type": "object",
"properties": {
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_time_entries(customer_id, project_id, time_id, date, start_date, ...)
List work time entries (customer, project, date, minutes, billable minutes, comment, invoice). Without filters FastBill returns the latest entries of the current month. time.get.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"time_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date": {
"description": "One day.",
"type": "string"
},
"start_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢fastbill_list_templates(limit, offset)
List the invoice/estimate templates (template id, name, hash). Use a template id with the create tools. Ids change whenever a template is edited. template.get.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Results per call, 1-100 (default 25). Every call counts against FastBill's hourly API quota.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_customer(customer_type, organization, first_name, last_name, salutation, ...)
WRITE: create a customer. customer_type is required; a business needs organization, a consumer needs last_name. Bank details are not accepted by this tool. FastBill does not check for duplicates, so search with fastbill_list_customers first. customer.create.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_type": {
"type": "string",
"enum": [
"business",
"consumer"
],
"description": "business or consumer."
},
"organization": {
"description": "Company name (required for a business customer).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"description": "Required for a consumer.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"salutation": {
"type": "string",
"enum": [
"mr",
"mrs",
"family"
]
},
"position": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"academic_degree": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address_2": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"zipcode": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country_code": {
"description": "ISO 3166 alpha-2, e.g. DE.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 254
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"mobile": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"website": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"vat_id": {
"description": "VAT identification number.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"customer_number": {
"description": "Own customer number (FastBill assigns one if omitted).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"days_for_payment": {
"description": "Days until payment is due (stored with payment_type 1 only).",
"type": "integer",
"minimum": 0,
"maximum": 3650
},
"payment_type": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"description": "1 transfer, 3 cash, 4 PayPal, 5 advance payment, 6 credit card (direct debit needs bank details: set it in FastBill)."
},
"tags": {
"description": "Comma-separated tags.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"customer_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴fastbill_update_customer(customer_id, customer_type, organization, first_name, last_name, ...)
WRITE: update fields of an existing customer; only the fields you pass change. Bank details are not accepted by this tool. customer.update.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill customer id."
},
"customer_type": {
"type": "string",
"enum": [
"business",
"consumer"
]
},
"organization": {
"description": "Company name (required for a business customer).",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"description": "Required for a consumer.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"salutation": {
"type": "string",
"enum": [
"mr",
"mrs",
"family"
]
},
"position": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"academic_degree": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address_2": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"zipcode": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country_code": {
"description": "ISO 3166 alpha-2, e.g. DE.",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 254
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"mobile": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"website": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"vat_id": {
"description": "VAT identification number.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"customer_number": {
"description": "Own customer number (FastBill assigns one if omitted).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"days_for_payment": {
"description": "Days until payment is due (stored with payment_type 1 only).",
"type": "integer",
"minimum": 0,
"maximum": 3650
},
"payment_type": {
"type": "integer",
"minimum": 1,
"maximum": 6,
"description": "1 transfer, 3 cash, 4 PayPal, 5 advance payment, 6 credit card (direct debit needs bank details: set it in FastBill)."
},
"tags": {
"description": "Comma-separated tags.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_invoice(customer_id, items, currency_code, template_id, introtext, ...)
WRITE: create an invoice for a customer from line items. FastBill stores it as a draft; it gets its number and becomes final only with fastbill_complete_invoice, and it is never sent by this tool. Check the result with fastbill_get_invoice. invoice.create.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill customer id (see fastbill_list_customers)."
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "Line description."
},
"unit_price": {
"type": "number",
"description": "Price per unit (net, or gross when is_gross is true)."
},
"vat_percent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "VAT in percent, e.g. 19."
},
"quantity": {
"description": "Quantity (default 1).",
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"description": "Unit, e.g. h or pcs.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"article_number": {
"description": "Article number of a FastBill product.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"discount_percent": {
"description": "Item discount in percent.",
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"required": [
"description",
"unit_price",
"vat_percent"
]
},
"description": "Line items (1-100)."
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"template_id": {
"description": "Template id from fastbill_list_templates.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"introtext": {
"description": "Introduction text above the items.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"is_gross": {
"description": "True when unit_price values are gross.",
"type": "boolean"
},
"discount_percent": {
"description": "Document discount in percent.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"invoice_title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"invoice_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"delivery_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"service_period_start": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"service_period_end": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"vat_case": {
"description": "VAT case (default standard).",
"type": "string",
"enum": [
"standard",
"small_business_regulation",
"b2c_eu_goods",
"b2c_noneu_goods",
"b2b_eu_goods",
"b2b_eu_services",
"b2b_noneu_goods",
"b2b_noneu_services"
]
},
"cash_discount_percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"cash_discount_days": {
"type": "integer",
"minimum": 0,
"maximum": 3650
},
"customer_order_reference": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contract_reference": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"customer_id",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴fastbill_complete_invoice(invoice_id)
WRITE, NOT REVERSIBLE: turn a draft invoice into a final invoice. FastBill assigns the invoice number and PDF; a final invoice can no longer be edited (it can only be canceled in FastBill). Nothing is sent to the customer. Only call this after the user confirmed the draft. invoice.complete.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill id of the DRAFT invoice."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴fastbill_set_invoice_paid(invoice_id, paid_date, payment_method)
WRITE: mark a final invoice as paid, with the payment date and method. invoice.setpaid.
Esquema de entrada
{
"type": "object",
"properties": {
"invoice_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill invoice id."
},
"paid_date": {
"description": "Date the payment arrived (default: FastBill's choice, today).",
"type": "string"
},
"payment_method": {
"description": "e.g. paypal, cash, bank name.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_estimate(customer_id, items, currency_code, template_id, introtext, ...)
WRITE: create an estimate (quote) for a customer from line items. It is not sent. estimate.create.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill customer id (see fastbill_list_customers)."
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "Line description."
},
"unit_price": {
"type": "number",
"description": "Price per unit (net, or gross when is_gross is true)."
},
"vat_percent": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "VAT in percent, e.g. 19."
},
"quantity": {
"description": "Quantity (default 1).",
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"description": "Unit, e.g. h or pcs.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"article_number": {
"description": "Article number of a FastBill product.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"discount_percent": {
"description": "Item discount in percent.",
"type": "number",
"minimum": 0,
"maximum": 100
}
},
"required": [
"description",
"unit_price",
"vat_percent"
]
},
"description": "Line items (1-100)."
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"template_id": {
"description": "Template id from fastbill_list_templates.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"introtext": {
"description": "Introduction text above the items.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"is_gross": {
"description": "True when unit_price values are gross.",
"type": "boolean"
},
"discount_percent": {
"description": "Document discount in percent.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"estimate_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
}
},
"required": [
"customer_id",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_article(article_number, title, unit_price, type, description, ...)
WRITE: create a product or service (article number, title and unit price are required). article.create.
Esquema de entrada
{
"type": "object",
"properties": {
"article_number": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Unique article number."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"unit_price": {
"type": "number"
},
"type": {
"type": "string",
"enum": [
"product",
"digital_product",
"service",
"none"
]
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"unit": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"vat_percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"is_gross": {
"description": "True when unit_price is gross.",
"type": "boolean"
},
"tags": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"article_number",
"title",
"unit_price"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_project(project_name, customer_id, hour_price, currency_code, vat_percent, ...)
WRITE: create a project for a customer (name and customer are required). project.create.
Esquema de entrada
{
"type": "object",
"properties": {
"project_name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "FastBill customer id."
},
"hour_price": {
"description": "Hourly rate.",
"type": "number",
"minimum": 0
},
"currency_code": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"vat_percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"start_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
}
},
"required": [
"project_name",
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡fastbill_create_time_entry(customer_id, project_id, start_time, end_time, minutes, ...)
WRITE: book a work time entry on a project (customer, project and start time are required). time.create.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"start_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time, YYYY-MM-DD hh:mm:ss."
},
"end_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time, YYYY-MM-DD hh:mm:ss."
},
"minutes": {
"description": "Duration in minutes (not calculated from the times).",
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"billable_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 100000
},
"article_id": {
"description": "The service (article id) of the entry.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date": {
"type": "string",
"description": "A date, yyyy-mm-dd."
},
"comment": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"customer_id",
"project_id",
"start_time"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada22 herramientas