{
"data": {
"error": {
"message": "No client with API-KEY '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx' was found.",
"errors": null,
"details": null
}
}
}
{
"data": {
"error": {
"message": "The given data was invalid.",
"errors": {
"invoice_exists": [
"An invoice already exists with the indicated invoice number and fiscal for the provided SIF. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]."
],
"incorrect_total_quota": [
"The total quota of the invoice does not match the total tax quota and equalization_tax_quota of the tax breakdown. Calculated total quota: [26.25]."
],
"incorrect_total_amount": [
"The total amount of the invoice does not match the total tax base of the tax breakdown. Calculated total amount: [151.25]."
]
},
"details": {
"request_id": "9ded9e2c-d59e-4432-a926-652cbcfac365"
}
}
}
}
API Reference
Nuevo SIF de empresa
Creación de un Sistema Informático de Facturación de empresa.
{
"data": {
"error": {
"message": "No client with API-KEY '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx' was found.",
"errors": null,
"details": null
}
}
}
{
"data": {
"error": {
"message": "The given data was invalid.",
"errors": {
"invoice_exists": [
"An invoice already exists with the indicated invoice number and fiscal for the provided SIF. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]."
],
"incorrect_total_quota": [
"The total quota of the invoice does not match the total tax quota and equalization_tax_quota of the tax breakdown. Calculated total quota: [26.25]."
],
"incorrect_total_amount": [
"The total amount of the invoice does not match the total tax base of the tax breakdown. Calculated total amount: [151.25]."
]
},
"details": {
"request_id": "9ded9e2c-d59e-4432-a926-652cbcfac365"
}
}
}
}
Número de instalación del sistema informático de facturación (SIF) utilizado. Deberá distinguirse de otros posibles SIF utilizados para realizar la facturación del obligado a expedir facturas, es decir, de otras posibles instalaciones de SIF pasadas, presentes o futuras utilizadas para realizar la facturación del obligado a expedir facturas, incluso aunque en dichas instalaciones se emplee el mismo SIF de un productor.
Código del país en formato ISO 3166-1 alpha-2. Sólo es necesario rellenarlo si el sujeto no es nacional. El código de país debe ser ES si other_tax_id_type_key es 07 (no censado). Ejemplo: DE
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"KubiFactu Docs","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/kubicode/c_MnoHUxTdI5_O4j/logo/light.svg?fit=max\u0026auto=format\u0026n=c_MnoHUxTdI5_O4j\u0026q=85\u0026s=ed19f7b6d4dbf284f34781b6b320ac48","dark":"https://mintcdn.com/kubicode/c_MnoHUxTdI5_O4j/logo/dark.svg?fit=max\u0026auto=format\u0026n=c_MnoHUxTdI5_O4j\u0026q=85\u0026s=3bee2696fbef6e0c54653a4e98280cf1"},"favicon":"https://mintcdn.com/kubicode/c_MnoHUxTdI5_O4j/favicon.svg?fit=max\u0026auto=format\u0026n=c_MnoHUxTdI5_O4j\u0026q=85\u0026s=ddbe44a854257f5d930e11e61f5cd1a7","api":{"playground":{"display":"interactive"},"mdx":{"server":["https://api.kubifactu.com","https://devapi.kubifactu.com"]}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Soporte"}]},"styling":{"codeblocks":"dark","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kubicode","hasAudioNarration":false,"actualSubdomain":"kubicode","customDomains":["apidocs.kubifactu.com"],"gitSource":{"type":"github","owner":"sportuondo","repo":"kubifactu-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae12722282ca4391afec090","collectionId":"290b5c66-88a3-485d-ae9a-b417d9af5d5c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae12722282ca4391afec090"},"entitlements":{},"buildId":"6ae12722282ca4391afec090","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"Ejemplos","count":22},{"language":"default","tag":"Referencia de la API","count":21},{"language":"default","tag":"Endpoints de KubiBAI","count":8},{"language":"default","tag":"Inicio","count":7},{"language":"default","tag":"Empieza","count":7},{"language":"default","tag":"Otros endpoints","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"openapi-reference/nuevo-sif-de-empresa","slug":"/openapi-reference/nuevo-sif-de-empresa","pageMetadata":{"title":"Nuevo SIF de empresa","description":"Creación de un Sistema Informático de Facturación de empresa.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/sifs","href":"/openapi-reference/nuevo-sif-de-empresa","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creación de un Sistema Informático de Facturación de empresa.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Nuevo SIF de empresa","description":"Creación de un Sistema Informático de Facturación de empresa.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/sifs","href":"/openapi-reference/nuevo-sif-de-empresa","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Nuevo SIF de empresa","description":"Creación de un Sistema Informático de Facturación de empresa.","operationId":"createClientCompanySif","parameters":["f0cd6b03-45fe-4a1e-9392-9870f77388d5"],"requestBody":"abf1e886-8e46-48d5-9d60-fd6dcefffa92","responses":{"200":"4f2632da-44d5-4eea-b257-b8a9c0a2e208","403":"f81d3d3a-8e88-48e7-8c95-cbf4babf24f3","422":"d6aff943-48e8-4ff2-96f0-1a2181c22ce1","500":"5993b6b7-77c7-4219-a386-15c62c3e5106"},"security":["3ed3a9dc-de09-47d6-98c1-9c7ffb3cd44c"],"method":"post","type":"path","servers":["303ac0a5-79a3-4351-acb8-8f25fe88f3ee","c6f56d55-3c61-4255-bb06-871019b322ea"],"path":"/api/clientcompanies/{companyId}/sifs","baseUrlOptions":["https://api.kubifactu.com","https://devapi.kubifactu.com"],"title":"Nuevo SIF de empresa","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f0cd6b03-45fe-4a1e-9392-9870f77388d5":{"name":"companyId","in":"path","description":"ID de la empresa.\n","required":true,"schema":{"type":"string","isRequired":true,"description":"ID de la empresa.\n","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_name":{"type":"string","description":"Nombre de la empresa.","example":"Empresa de ejemplo","isRequired":true,"uniqueKey":"company_name","typeLabel":"string"},"tax_id_number":{"type":"string","description":"NIF/CIF de la empresa.","example":"S6271969E","isRequired":true,"uniqueKey":"tax_id_number","typeLabel":"string"},"name":{"type":"string","description":"Nombre del SIF.","maxLength":30,"example":"SIF-0001","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"sif_id":{"type":"string","maxLength":2,"description":"Identificador del SIF para Veri*Factu. Deberá distinguirse de otros posibles SIFs que produzca esta entidad productora.\n\nDeberá tener rellenadas siempre las dos posiciones, cada una de las cuales deberá ser una letra mayúscula, excepto la Ñ, o un dígito numérico.\n","isRequired":true,"uniqueKey":"sif_id","typeLabel":"string"},"version":{"type":"string","description":"Versión en formato X.Y.Z del SIF.","example":"1.0.0","isRequired":true,"uniqueKey":"version","typeLabel":"string"},"installation_number":{"type":"string","maxLength":100,"description":"Número de instalación del sistema informático de facturación (SIF) utilizado. Deberá distinguirse de otros posibles SIF utilizados para realizar la facturación del obligado a expedir facturas, es decir, de otras posibles instalaciones de SIF pasadas, presentes o futuras utilizadas para realizar la facturación del obligado a expedir facturas, incluso aunque en dichas instalaciones se emplee el mismo SIF de un productor.","example":"LQLFBFLMUSLAEMU7SC2BROSETQU7SSRIKJDRW2QHVMCPE574M4JORYRDLWPS3NRXWJ3APCNKWWXO771GSIO731KXTAUPIMXWV33Y","isRequired":true,"uniqueKey":"installation_number","typeLabel":"string"},"other_country_code":{"type":"string","description":"Código del país en formato [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2). Sólo es necesario rellenarlo **si el sujeto no es nacional**. El código de país debe ser `ES` si `other_tax_id_type_key` es `07 (no censado)`. Ejemplo: `DE`\n","uniqueKey":"other_country_code","typeLabel":"string"},"other_tax_id_type_key":{"type":"string","description":"Clave para identificar el tipo de documento. Los valores posibles son:\n\n- `02`: **NIF-IVA**: Número de Identificación Fiscal para IVA.\n- `03`: **Pasaporte**: Documento oficial que acredita la identidad y nacionalidad del portador.\n- `04`: **Documento oficial de identificación expedido por el país o territorio de residencia**.\n- `05`: **Certificado de residencia**: Documento que acredita la residencia fiscal.\n- `06`: **Otro documento probatorio**: Documento adicional que sirve como prueba de identidad.\n- `07`: **No censado**: El receptor no está registrado en el censo fiscal.\n","enum":["02","03","04","05","06","07"],"uniqueKey":"other_tax_id_type_key","typeLabel":"enum\u003cstring>"},"other_tax_id_number":{"type":"string","description":"Número de identificación en el país de residencia del sujeto. Ejemplo: `L74JF44L2` para una empresa de `DE`.\n","uniqueKey":"other_tax_id_number","typeLabel":"string"}},"required":["company_name","tax_id_number","name","sif_id","version","installation_number"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"company_name":"Empresa de ejemplo","tax_id_number":"S6271969E","name":"SIF-0001","sif_id":"\u003cstring>","version":"1.0.0","installation_number":"LQLFBFLMUSLAEMU7SC2BROSETQU7SSRIKJDRW2QHVMCPE574M4JORYRDLWPS3NRXWJ3APCNKWWXO771GSIO731KXTAUPIMXWV33Y","other_country_code":"\u003cstring>","other_tax_id_number":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4f2632da-44d5-4eea-b257-b8a9c0a2e208":{"description":"Empresa creada con éxito.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del SIF.","example":"9dccd6c6-08f8-490d-a370-bfef724c0855","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"company_name":{"type":"string","description":"Nombre de la empresa asociada al SIF.","example":"Empresa de ejemplo","uniqueKey":"data.company_name","typeLabel":"string"},"tax_id_number":{"type":"string","description":"NIF/CIF de la empresa asociada al SIF.","example":"S6271969E","uniqueKey":"data.tax_id_number","typeLabel":"string"},"other_country_code":{"type":"string","description":"Código del país en formato [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-2). Sólo es necesario rellenarlo **si el sujeto no es nacional**. El código de país debe ser `ES` si `other_tax_id_type_key` es `07 (no censado)`. Ejemplo: `DE`\n","uniqueKey":"data.other_country_code","typeLabel":"string"},"other_tax_id_type_key":{"type":"string","description":"Clave para identificar el tipo de documento. Los valores posibles son:\n\n- `02`: **NIF-IVA**: Número de Identificación Fiscal para IVA.\n- `03`: **Pasaporte**: Documento oficial que acredita la identidad y nacionalidad del portador.\n- `04`: **Documento oficial de identificación expedido por el país o territorio de residencia**.\n- `05`: **Certificado de residencia**: Documento que acredita la residencia fiscal.\n- `06`: **Otro documento probatorio**: Documento adicional que sirve como prueba de identidad.\n- `07`: **No censado**: El receptor no está registrado en el censo fiscal.\n","enum":["02","03","04","05","06","07"],"uniqueKey":"data.other_tax_id_type_key","typeLabel":"enum\u003cstring>"},"other_tax_id_number":{"type":"string","description":"Número de identificación en el país de residencia de la empresa. Ejemplo: `L74JF44L2` para una empresa de `DE`.\n","uniqueKey":"data.other_tax_id_number","typeLabel":"string"},"name":{"type":"string","description":"Nombre del SIF.","example":"SIF 0001","uniqueKey":"data.name","typeLabel":"string"},"sif_id":{"type":"string","description":"Identificador del SIF para Veri*Factu.","example":"DC","uniqueKey":"data.sif_id","typeLabel":"string"},"version":{"type":"string","description":"Versión del SIF.","example":"1.0.0","uniqueKey":"data.version","typeLabel":"string"},"installation_number":{"type":"string","description":"Número de instalación asociado al SIF.","example":"BM1WJ36SS5MOL6LWPLHTMBFUOTQO5TNDU2ILL34JG6FLSVAUMD1I0G41AS7PC870QAHHIOWJSBPKRB2XELRCUWO4TSJ8XY0UPAML","uniqueKey":"data.installation_number","typeLabel":"string"},"only_verifactu_use_key":{"type":"string","description":"Indica si el SIF es solo para uso de Veri*Factu.\nValores posibles: `S` (Sí), `N` (No).\n","example":"S","uniqueKey":"data.only_verifactu_use_key","typeLabel":"string"},"multi_ot_key":{"type":"string","description":"Indica si el SIF admite operaciones de registros de facturación de múltiples empresas.\nValores posibles: `S` (Sí), `N` (No).\n","example":"N","uniqueKey":"data.multi_ot_key","typeLabel":"string"},"supporting_multiple_ots_key":{"type":"string","description":"Indica si el SIF soporta actualmente el procesamiento de registros de facturación de múltiples empresas.\nValores posibles: `S` (Sí), `N` (No).\n","example":"N","uniqueKey":"data.supporting_multiple_ots_key","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"9dccd6c6-08f8-490d-a370-bfef724c0855","company_name":"Empresa de ejemplo","tax_id_number":"S6271969E","other_country_code":"\u003cstring>","other_tax_id_type_key":"02","other_tax_id_number":"\u003cstring>","name":"SIF 0001","sif_id":"DC","version":"1.0.0","installation_number":"BM1WJ36SS5MOL6LWPLHTMBFUOTQO5TNDU2ILL34JG6FLSVAUMD1I0G41AS7PC870QAHHIOWJSBPKRB2XELRCUWO4TSJ8XY0UPAML","only_verifactu_use_key":"S","multi_ot_key":"N","supporting_multiple_ots_key":"N"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f81d3d3a-8e88-48e7-8c95-cbf4babf24f3":{"description":"No autorizado. La API-KEY proporcionada no es válida.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Mensaje detallado del error.","example":"No client with API-KEY '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx' was found.","uniqueKey":"data.error.message","typeLabel":"string"},"errors":{"oneOf":[{"type":"object","description":"Detalles adicionales del error. Puede ser `null` si no hay información específica.\n","example":null,"uniqueKey":"data.error.errors.oneOf.0","typeLabel":"object"},{"type":"null","description":"Detalles adicionales del error. Puede ser `null` si no hay información específica.\n","example":null,"uniqueKey":"data.error.errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.error.errors","typeLabel":"object | null"},"details":{"oneOf":[{"type":"object","enum":[null],"description":"Siempre es `null` en esta respuesta. La API-KEY se rechaza antes de asignar el identificador de la solicitud.","example":null,"uniqueKey":"data.error.details.oneOf.0","typeLabel":"object"},{"type":"null","enum":[null],"description":"Siempre es `null` en esta respuesta. La API-KEY se rechaza antes de asignar el identificador de la solicitud.","example":null,"uniqueKey":"data.error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.error.details","typeLabel":"object | null"}},"uniqueKey":"data.error","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"error":{"message":"No client with API-KEY '5tVySMGJOpq8HfMgIX28Qz6kF0dFOoq37x55PLZcWsGeGeYkNgJyAcRTlFJ5NbVoDRm8qtCywEoiN3A9JkBanMBXYmxiqR3BItxgxx' was found.","errors":null,"details":null}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d6aff943-48e8-4ff2-96f0-1a2181c22ce1":{"description":"Errores de validación.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Mensaje general del error.","example":"The given data was invalid.","uniqueKey":"data.error.message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"data.error.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.error.errors.additionalProperties","typeLabel":"string[]"},"description":"Lista de errores de validación organizados por campo.\nCada clave es el nombre del campo asociado al error y contiene un array de mensajes.\n","example":{"invoice_exists":["An invoice already exists with the indicated invoice number and fiscal for the provided SIF. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]."],"incorrect_total_quota":["The total quota of the invoice does not match the total tax quota and equalization_tax_quota of the tax breakdown. Calculated total quota: [26.25]."],"incorrect_total_amount":["The total amount of the invoice does not match the total tax base of the tax breakdown. Calculated total amount: [151.25]."]},"uniqueKey":"data.error.errors","typeLabel":"object"},"details":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid","description":"Identificador único de la solicitud para rastreo.","example":"9ded9e2c-d59e-4432-a926-652cbcfac365","uniqueKey":"data.error.details.request_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"data.error.details","typeLabel":"object"}},"uniqueKey":"data.error","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"error":{"message":"The given data was invalid.","errors":{"invoice_exists":["An invoice already exists with the indicated invoice number and fiscal for the provided SIF. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]."],"incorrect_total_quota":["The total quota of the invoice does not match the total tax quota and equalization_tax_quota of the tax breakdown. Calculated total quota: [26.25]."],"incorrect_total_amount":["The total amount of the invoice does not match the total tax base of the tax breakdown. Calculated total amount: [151.25]."]},"details":{"request_id":"9ded9e2c-d59e-4432-a926-652cbcfac365"}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"5993b6b7-77c7-4219-a386-15c62c3e5106":{"description":"Error interno del servidor.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"3ed3a9dc-de09-47d6-98c1-9c7ffb3cd44c":{"owner_api_key":{"type":"apiKey","name":"X-Qbikode-UserApiKey","in":"header","description":"API-KEY del intermediario que hace la petición. Este dato se puede consultar en el panel web, en la página de _Perfil de usuario_.\n","scopes":[],"schemeName":"owner_api_key"}}},"servers":{"303ac0a5-79a3-4351-acb8-8f25fe88f3ee":{"url":"https://api.kubifactu.com","description":"Servidor de producción"},"c6f56d55-3c61-4255-bb06-871019b322ea":{"url":"https://devapi.kubifactu.com","description":"Servidor de pruebas"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"X-Qbikode-UserApiKey","in":"header","description":"API-KEY del intermediario que hace la petición. Este dato se puede consultar en el panel web, en la página de _Perfil de usuario_.\n","scopes":[],"schemeName":"owner_api_key"},"schema":{"title":"X-Qbikode-UserApiKey","type":"string","description":"API-KEY del intermediario que hace la petición. Este dato se puede consultar en el panel web, en la página de _Perfil de usuario_.\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"owner_api_key","name":"X-Qbikode-UserApiKey"}],"title":"owner_api_key"}]},"originalFileLocation":"api-reference/openapi/openapi.yaml"},"subdomain":"kubicode","siteName":"KubiFactu Docs","title":"Nuevo SIF de empresa - KubiFactu Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T22:36:06.448Z","originalFileLocation":"openapi-reference/nuevo-sif-de-empresa.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creación de un Sistema Informático de Facturación de empresa.\">\u003cmeta data-mint-head name=\"application-name\" content=\"KubiFactu Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Nuevo SIF de empresa - KubiFactu Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creación de un Sistema Informático de Facturación de empresa.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KubiFactu Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kubicode.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Nuevo+SIF+de+empresa\u0026amp;description=Creaci%C3%B3n+de+un+Sistema+Inform%C3%A1tico+de+Facturaci%C3%B3n+de+empresa.\u0026amp;theme=01d1c3eb4c7167906a629986\u0026amp;signature=ef7fe501b3b07b9d71b860c2d1f85b988c04a4bd44452709a446771dec62a7dd\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Nuevo SIF de empresa - KubiFactu Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creación de un Sistema Informático de Facturación de empresa.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kubicode.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Nuevo+SIF+de+empresa\u0026amp;description=Creaci%C3%B3n+de+un+Sistema+Inform%C3%A1tico+de+Facturaci%C3%B3n+de+empresa.\u0026amp;theme=01d1c3eb4c7167906a629986\u0026amp;signature=ef7fe501b3b07b9d71b860c2d1f85b988c04a4bd44452709a446771dec62a7dd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/kubicode/1A_Cda9BuxxW99b3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KubiFactu Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/openapi-reference/nuevo-sif-de-empresa.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://apidocs.kubifactu.com/#organization\",\"name\":\"KubiFactu Docs\",\"url\":\"https://apidocs.kubifactu.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kubicode/c_MnoHUxTdI5_O4j/logo/light.svg?fit=max\u0026auto=format\u0026n=c_MnoHUxTdI5_O4j\u0026q=85\u0026s=ed19f7b6d4dbf284f34781b6b320ac48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://apidocs.kubifactu.com#website\",\"name\":\"KubiFactu Docs\",\"url\":\"https://apidocs.kubifactu.com\",\"publisher\":{\"@id\":\"https://apidocs.kubifactu.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa#webpage\",\"url\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa\",\"name\":\"Nuevo SIF de empresa\",\"description\":\"Creación de un Sistema Informático de Facturación de empresa.\",\"dateModified\":\"2026-10-27T22:36:06.448Z\",\"isPartOf\":{\"@id\":\"https://apidocs.kubifactu.com#website\"},\"breadcrumb\":{\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://apidocs.kubifactu.com/openapi-reference/listar-registros-de-facturaci%C3%B3n-con-filtros\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Nuevo SIF de empresa\",\"item\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa#apireference\",\"headline\":\"Nuevo SIF de empresa\",\"name\":\"Nuevo SIF de empresa\",\"description\":\"Creación de un Sistema Informático de Facturación de empresa.\",\"url\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa\",\"mainEntityOfPage\":{\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa#webpage\"},\"dateModified\":\"2026-10-27T22:36:06.448Z\",\"publisher\":{\"@id\":\"https://apidocs.kubifactu.com/#organization\"},\"isPartOf\":{\"@id\":\"https://apidocs.kubifactu.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"KubiFactu Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"KubiFactu Docs","nav":{"global":null,"tabs":[{"tab":"Inicio","pages":[{"title":"Inicio","href":"/changelog"}]},{"tab":"Referencia de la API","groups":[{"group":"API Reference","pages":[{"title":"Listar registros de facturación con filtros","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices","href":"/openapi-reference/listar-registros-de-facturación-con-filtros"},{"title":"Enviar registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/invoices","href":"/openapi-reference/enviar-registro-de-facturación"},{"title":"Enviar registro de facturación diferido","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/invoices/deferred","href":"/openapi-reference/enviar-registro-de-facturación-diferido"},{"title":"Enviar registros de facturación en lote","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/invoices/batch","href":"/openapi-reference/enviar-registros-de-facturación-en-lote"},{"title":"Obtener registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}","href":"/openapi-reference/obtener-registro-de-facturación"},{"title":"Descargar XML del registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/xml","href":"/openapi-reference/descargar-xml-del-registro-de-facturación"},{"title":"Descargar imagen QR del registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/qr-image","href":"/openapi-reference/descargar-imagen-qr-del-registro-de-facturación"},{"title":"Consultar registro de facturación con Veri*Factu","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/query","href":"/openapi-reference/consultar-registro-de-facturación-con-veri*factu"},{"title":"Reenviar registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/resubmit","href":"/openapi-reference/reenviar-registro-de-facturación"},{"title":"Anular registro de facturación","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/invoices/{invoiceId}/cancel","href":"/openapi-reference/anular-registro-de-facturación"},{"title":"Anular registro de facturación en diferido","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/invoices/{invoiceId}/deferredcancel","href":"/openapi-reference/anular-registro-de-facturación-en-diferido"},{"title":"Obtener lista de empresas","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/clientcompanies","href":"/openapi-reference/obtener-lista-de-empresas"},{"title":"Crear una nueva empresa","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies","href":"/openapi-reference/crear-una-nueva-empresa"},{"title":"Obtener datos de empresa","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}","href":"/openapi-reference/obtener-datos-de-empresa"},{"title":"Editar empresa","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}","href":"/openapi-reference/editar-empresa"},{"title":"Obtener operaciones de una empresa","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}/requests","href":"/openapi-reference/obtener-operaciones-de-una-empresa"},{"title":"Obtener SIFs de empresa","description":"Obtención de los Sistemas Informáticos de Facturación de la empresa.","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}/sifs","href":"/openapi-reference/obtener-sifs-de-empresa"},{"title":"Nuevo SIF de empresa","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/sifs","href":"/openapi-reference/nuevo-sif-de-empresa"},{"title":"Subir documentos de autorización","description":"Sube documentos de autorización y/o identidad para una empresa cliente.\n\nEste endpoint permite subir uno o ambos documentos simultáneamente:\n- Solo documento de autorización\n- Solo documento de identidad\n- Ambos documentos a la vez\n- Documento de autorización con indicador de firma digital del cliente (`authorization_document_has_digital_signature`)\n\nEl campo `authorization_document_has_digital_signature` puede enviarse junto con `authorization_document`.\nSi se sube solo `identity_document`, este indicador no aplica.\n\n**Nota:** Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/authorization-documents","href":"/openapi-reference/subir-documentos-de-autorización"},{"title":"Estado del servicio Veri*Factu","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml get /api/verifactu/health","href":"/openapi-reference/estado-del-servicio-veri*factu"},{"title":"Eliminar SIF","deprecated":null,"version":null,"openapi":"/api-reference/openapi/openapi.yaml delete /api/sifs/{sifId}","href":"/openapi-reference/eliminar-sif"}]}]},{"tab":"Endpoints de KubiBAI","pages":[{"title":"Endpoints de KubiBAI","href":"/openapi-kubibai-reference/enviar-registro-de-facturación"}]},{"tab":"Otros endpoints","pages":[{"title":"Otros endpoints","href":"/openapi-common/buscar-registros-de-facturación"}]},{"tab":"Ejemplos","pages":[{"title":"Ejemplos","href":"/api-reference/facturas/examples/basic"}]}]},"basePath":"","title":"Nuevo SIF de empresa - KubiFactu Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}