POST
/
api
/
invoicing
/
invoices
curl --request POST \
  --url https://api.kubifactu.com/api/invoicing/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",
  "sender_data": {
    "sender_full_name": "<string>",
    "sender_id_card_number": "<string>"
  },
  "recipients": [
    {
      "full_name": "<string>",
      "tax_id_number": "<string>",
      "other_id_country_code": "<string>",
      "other_id_type": "02",
      "other_id_card_id": "<string>"
    }
  ],
  "invoice_data": {
    "invoice_type_key": "F1",
    "fiscal_year": 2025,
    "series_code": "2025",
    "invoice_number": "00021",
    "invoice_datetime": "2025-02-26 12:35:44",
    "operation_date": "2025-02-26",
    "description": "<string>",
    "representative_company_name": "<string>",
    "representative_tax_id_number": "<string>",
    "previous_rejection_key": "S",
    "correction_key": "S",
    "is_simplified": false,
    "without_recipient_identification_key": "S",
    "macrodata_key": "S",
    "coupon_key": "N",
    "invoicing_agreement_registration_number": "<string>",
    "sif_agreement_id": "<string>",
    "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_code": "S",
    "rectified_base_amount": 2500.55,
    "rectified_quota": 42.3,
    "rectified_equalization_tax_quota": 5.2,
    "replaced_rectified_invoices": [
      {
        "tax_id_number": "<string>",
        "full_invoice_number": "<string>",
        "invoice_date": "2025-02-26"
      }
    ],
    "substituted_invoices": [
      {
        "tax_id_number": "<string>",
        "full_invoice_number": "<string>",
        "invoice_date": "2025-02-26"
      }
    ],
    "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
  }
}'
{
  "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 cuestión.

Body

application/json

Response

200
application/json

Factura enviada con éxito.

The response is of type object.