POST
/
api
/
invoices
curl --request POST \
  --url https://api.kubifactu.com/api/invoices \
  --header 'Content-Type: application/json' \
  --header 'X-Qbikode-ClientApiKey: <api-key>' \
  --data '{
  "callback_url": "https://www.tuempresa.com/kubifactu/callback",
  "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
  "invoice_type_key": "F1",
  "sender_data": {
    "company_name": "<string>",
    "tax_id_number": "<string>"
  },
  "recipients": [
    {
      "company_name": "<string>",
      "tax_id_number": "<string>",
      "other_country_code": "<string>",
      "other_tax_id_type_key": "02",
      "other_tax_id_number": "<string>"
    }
  ],
  "representative_company_name": "<string>",
  "representative_tax_id_number": "<string>",
  "previous_rejection_key": "S",
  "correction_key": "S",
  "full_invoice_number": "2025-00001",
  "fiscal_year": 2025,
  "issue_date": "2025-02-26",
  "operation_date": "2025-02-26",
  "operation_description": "<string>",
  "lines": [
    {
      "tax_type_key": "01",
      "vat_tax_regime_key": "01",
      "igic_tax_regime_key": "01",
      "operation_type_key": "S1",
      "exemption_cause_key": "E1",
      "tax_base": 200,
      "tax_base_at_cost": 123,
      "tax_rate": 21,
      "tax_quota": 42,
      "equalization_tax_rate": 5.2,
      "equalization_tax_quota": 10.4
    }
  ],
  "total_quota": 123,
  "total_amount": 123,
  "simplified_invoice_key": "S",
  "without_recipient_identification_key": "S",
  "macrodata_key": "S",
  "issued_by_third_party_or_recipient_key": "T",
  "third_party_data": {
    "company_name": "<string>",
    "tax_id_number": "<string>",
    "other_country_code": "<string>",
    "other_tax_id_type_key": "02",
    "other_tax_id_number": "<string>"
  },
  "rectificative_type_key": "S",
  "rectified_tax_base": 2500.55,
  "rectified_tax_quota": 42.3,
  "rectified_equalization_tax_quota": 5.2,
  "rectified_invoices": [
    {
      "tax_id_number": "<string>",
      "full_invoice_number": "<string>",
      "issue_date": "2025-02-26"
    }
  ],
  "substituted_invoices": [
    {
      "tax_id_number": "<string>",
      "full_invoice_number": "<string>",
      "issue_date": "2025-02-26"
    }
  ],
  "coupon_key": "N",
  "invoicing_agreement_registration_number": "<string>",
  "sif_agreement_id": "<string>"
}'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "record_type": "creation",
    "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
    "full_invoice_number": "<string>",
    "fingerprint": "<string>",
    "vf_post_status": "success",
    "vf_record_registration_status": "success",
    "has_warnings": false,
    "vf_error_descriptions": "<string>",
    "next_request_waiting_time": 123,
    "next_request_datetime": "1977-04-22T06:00:00Z",
    "qr_value": "<string>",
    "qr_image": "aSDinaTvuI8gbWludGxpZnk=",
    "xml_contents": "aSDinaTvuI8gbWludGxpZnk="
  }
}

Authorizations

​
X-Qbikode-ClientApiKey
string
header
required

API-KEY de la empresa que hace la petición. Este dato se puede consultar en el panel web, accediendo a la sección Empresas y accediendo a la ficha de la empresa en.

Body

application/json

Response

200
application/json

Factura enviada con éxito.

The response is of type object.