{
"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
Subir documentos de autorización
Sube documentos de autorización y/o identidad para una empresa cliente.
Este endpoint permite subir uno o ambos documentos simultáneamente:
Solo documento de autorización
Solo documento de identidad
Ambos documentos a la vez
Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature)
El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document.
Si se sube solo identity_document, este indicador no aplica.
Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.
{
"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"
}
}
}
}
Al menos uno de los dos documentos es requerido.
El campo authorization_document_has_digital_signature permite indicar firma digital en el documento de autorización y, en ese caso, considerar opcional el documento de identidad para la lógica de completitud.
Documento de identidad del representante legal. Sólo necesario si el documento de autorización no está firmado digitalmente por el cliente. Formatos permitidos: PDF, JPG, JPEG, PNG.
Tamaño máximo: 25MB.
Indicador de que el documento de autorización está firmado digitalmente con el certificado digital del cliente.
Solo se tiene en cuenta cuando se envía authorization_document.
{"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/subir-documentos-de-autorización","slug":"/openapi-reference/subir-documentos-de-autorización","pageMetadata":{"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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Sube documentos de autorización y/o identidad para una empresa cliente.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Este endpoint permite subir uno o ambos documentos simultáneamente:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Solo documento de autorización\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Solo documento de identidad\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Ambos documentos a la vez\"\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Documento de autorización con indicador de firma digital del cliente (\", _jsx(_components.code, {\n children: \"authorization_document_has_digital_signature\"\n }), \")\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"El campo \", _jsx(_components.code, {\n children: \"authorization_document_has_digital_signature\"\n }), \" puede enviarse junto con \", _jsx(_components.code, {\n children: \"authorization_document\"\n }), \".\\nSi se sube solo \", _jsx(_components.code, {\n children: \"identity_document\"\n }), \", este indicador no aplica.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Nota:\"\n }), \" Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\"]\n })]\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":"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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"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","operationId":"uploadAuthorizationDocuments","parameters":["e223492e-3516-4878-90e8-26797442598a"],"requestBody":"5fcf6cb7-0146-4ff0-b1fe-07a2266b1a6b","responses":{"200":"d6a947c1-4479-4e93-9cac-2b9234423eed","403":"e2abc55e-c230-4a63-baef-f45240b663bc","422":"5432b0da-25fd-49c7-8fd0-8d19103151c5","500":"84c4b391-e5ae-47ae-b1ef-7d6d5b815c9a"},"security":["79eee1d6-386e-4398-af5d-b6e6040829be"],"method":"post","type":"path","servers":["303ac0a5-79a3-4351-acb8-8f25fe88f3ee","c6f56d55-3c61-4255-bb06-871019b322ea"],"path":"/api/clientcompanies/{companyId}/authorization-documents","baseUrlOptions":["https://api.kubifactu.com","https://devapi.kubifactu.com"],"title":"Subir documentos de autorización","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e223492e-3516-4878-90e8-26797442598a":{"name":"companyId","in":"path","description":"ID de la empresa cliente.","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"ID de la empresa cliente.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"authorization_document":{"type":"string","format":"binary","description":"Documento de autorización firmado. Formatos permitidos: PDF, JPG, JPEG, PNG.\nTamaño máximo: 25MB.\n","uniqueKey":"authorization_document","typeLabel":"file"},"identity_document":{"type":"string","format":"binary","description":"Documento de identidad del representante legal. Sólo necesario si el documento de autorización no está firmado digitalmente por el cliente. Formatos permitidos: PDF, JPG, JPEG, PNG.\nTamaño máximo: 25MB.\n","uniqueKey":"identity_document","typeLabel":"file"},"authorization_document_has_digital_signature":{"type":"boolean","description":"Indicador de que el documento de autorización está firmado digitalmente con el certificado digital del cliente.\nSolo se tiene en cuenta cuando se envía `authorization_document`.\n","uniqueKey":"authorization_document_has_digital_signature","typeLabel":"boolean"}},"description":"Al menos uno de los dos documentos es requerido.\nEl campo `authorization_document_has_digital_signature` permite indicar firma digital en el documento de autorización y, en ese caso, considerar opcional el documento de identidad para la lógica de completitud.\n","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"authorization_document":"\u003cstring>","identity_document":"\u003cstring>","authorization_document_has_digital_signature":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d6a947c1-4479-4e93-9cac-2b9234423eed":{"description":"Documento(s) subido(s) con éxito.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"type":"string","description":"Mensaje de confirmación.","example":"Documents uploaded successfully.","uniqueKey":"data.message","typeLabel":"string"},"authorization_document":{"oneOf":[{"type":"string","description":"Nombre del archivo de autorización guardado.","example":"auth_20260129153045.pdf","uniqueKey":"data.authorization_document.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nombre del archivo de autorización guardado.","example":"auth_20260129153045.pdf","uniqueKey":"data.authorization_document.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.authorization_document","typeLabel":"string | null"},"identity_document":{"oneOf":[{"type":"string","description":"Nombre del archivo de identidad guardado.","example":"identity_20260129153046.jpg","uniqueKey":"data.identity_document.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nombre del archivo de identidad guardado.","example":"identity_20260129153046.jpg","uniqueKey":"data.identity_document.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.identity_document","typeLabel":"string | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"message":"Documents uploaded successfully.","authorization_document":"auth_20260129153045.pdf","identity_document":"identity_20260129153046.jpg"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e2abc55e-c230-4a63-baef-f45240b663bc":{"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"},"5432b0da-25fd-49c7-8fd0-8d19103151c5":{"description":"Errores de validación. Posibles causas:\n- La empresa no existe o no pertenece al owner\n- No se proporcionó ningún documento\n- El archivo excede 25MB\n- Tipo de archivo no permitido (solo pdf, jpg, jpeg, png)\n- El owner usa su propio certificado\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"},"84c4b391-e5ae-47ae-b1ef-7d6d5b815c9a":{"description":"Error interno del servidor.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"79eee1d6-386e-4398-af5d-b6e6040829be":{"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":"Subir documentos de autorización - KubiFactu Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T22:36:06.458Z","originalFileLocation":"openapi-reference/subir-documentos-de-autorización.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=\"Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature) El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document. Si se sube solo identity_document, este indicador no aplica. Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\">\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=\"Subir documentos de autorización - KubiFactu Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature) El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document. Si se sube solo identity_document, este indicador no aplica. Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\">\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/subir-documentos-de-autorización\">\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=Subir+documentos+de+autorizaci%C3%B3n\u0026amp;description=Sube+documentos+de+autorizaci%C3%B3n+y%2Fo+identidad+para+una+empresa+cliente.%0A%0AEste+endpoint+permite+subir+uno+o+ambos+documentos+simult%C3%A1neamente%3A%0A-+Solo+documento+de\u0026amp;theme=01d1c3eb4c7167906a629986\u0026amp;signature=a8b7e95d6d0725a81569ae7512a5c58e93e2d3220511e67a8acde960e4a03d28\">\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=\"Subir documentos de autorización - KubiFactu Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature) El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document. Si se sube solo identity_document, este indicador no aplica. Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kubicode.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Subir+documentos+de+autorizaci%C3%B3n\u0026amp;description=Sube+documentos+de+autorizaci%C3%B3n+y%2Fo+identidad+para+una+empresa+cliente.%0A%0AEste+endpoint+permite+subir+uno+o+ambos+documentos+simult%C3%A1neamente%3A%0A-+Solo+documento+de\u0026amp;theme=01d1c3eb4c7167906a629986\u0026amp;signature=a8b7e95d6d0725a81569ae7512a5c58e93e2d3220511e67a8acde960e4a03d28\">\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/subir-documentos-de-autorización\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/openapi-reference/subir-documentos-de-autorizaci%C3%B3n.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/subir-documentos-de-autorizaci%C3%B3n#webpage\",\"url\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n\",\"name\":\"Subir documentos de autorización\",\"description\":\"Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature) El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document. Si se sube solo identity_document, este indicador no aplica. Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\",\"dateModified\":\"2026-10-27T22:36:06.458Z\",\"isPartOf\":{\"@id\":\"https://apidocs.kubifactu.com#website\"},\"breadcrumb\":{\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n#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\":\"Subir documentos de autorización\",\"item\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n#apireference\",\"headline\":\"Subir documentos de autorización\",\"name\":\"Subir documentos de autorización\",\"description\":\"Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (authorization_document_has_digital_signature) El campo authorization_document_has_digital_signature puede enviarse junto con authorization_document. Si se sube solo identity_document, este indicador no aplica. Nota: Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital.\",\"url\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n\",\"mainEntityOfPage\":{\"@id\":\"https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorizaci%C3%B3n#webpage\"},\"dateModified\":\"2026-10-27T22:36:06.458Z\",\"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","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","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"},{"title":"Subir documentos de autorizació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","description":"Obtiene el estado actual del servicio Veri*Factu de la AEAT.\n\nEste endpoint devuelve información sobre la disponibilidad del servicio, incluyendo el código de estado HTTP de la última comprobación y cualquier mensaje de error si el servicio no está disponible.\n","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":"Subir documentos de autorización - 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"]}