Preparar la certificación del negocio

POST

/v1/business/certification

curl --request POST \
  --url https://api.timbro.do/v1/business/certification \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: example' \
  --data '{ "path": "own_software" }'

• API de Timbro

Crea el vínculo con el ambiente de certificación y el proceso de 15 pasos de la DGII. external_software está disponible para los negocios que usan Timbro; own_software requiere que el equipo de Timbro verifique la elegibilidad. Timbro asigna la versión del software.

Autenticación

• adminKey

Parámetros

Parámetros de cabecera

idempotency-key

obligatorio

string

>= 1 characters <= 255 characters /^[\x20-\x7e]+$/

Cuerpo de la solicitud^obligatorio

Media typeapplication/json

object

path

obligatorio

Cualquiera de:

string

string

Valor permitido: own_software

string

string

Valor permitido: external_software

Respuestas

200

200

Preparación de la certificación y avance ante la DGII que informó el negocio autenticado. Nada de esto da acceso al modo en vivo.

Media typeapplication/json

Campos y códigos de la respuesta

discriminator: status

BusinessCertificationNotStarted

object

object

obligatorio

string

Valor permitido: business_certification

status

obligatorio

string

Valor permitido: not_started

requirements

obligatorio

Array<object>

Lo que falta, quién lo resuelve y qué pasos esperan por eso. Desde el paso 12, Timbro recibe en producción los documentos del negocio; un requisito production_reception_* detiene el paso 12 hasta que eso ocurra. Volver a informar o declarar el paso 12 lo intenta de nuevo cuando lo hace una persona propietaria o una clave de administrador; si el requisito está a cargo del equipo de Timbro, espera a que el equipo lo resuelva.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: invoices_not_requested

string

string

Valor permitido: fiscal_details_incomplete

string

string

Valor permitido: certification_binding_required

string

string

Valor permitido: certification_certificate_required

string

string

Valor permitido: provider_eligibility_unverified

string

string

Valor permitido: certification_test_set_processing_unavailable

string

string

Valor permitido: certification_provider_acceptance_pending

string

string

Valor permitido: production_reception_certificate_required

string

string

Valor permitido: production_reception_integration_required

string

string

Valor permitido: production_reception_held_elsewhere

string

string

Valor permitido: production_reception_not_started

string

string

Valor permitido: production_reception_owner_required

string

string

Valor permitido: production_reception_receiver_missing

string

string

Valor permitido: production_reception_operator_review

string

string

Valor permitido: production_reception_already_filed

owner

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

string

string

Valor permitido: operator

blocks

obligatorio

Array

<= 4 items

field

string

availablePaths

obligatorio

Array

>= 1 items

recommendedPath

obligatorio

Cualquiera de:

string

string

Valor permitido: own_software

string

string

Valor permitido: external_software

actions

obligatorio

Array

<= 1 items

BusinessCertificationInProgress

object

object

obligatorio

string

Valor permitido: business_certification

id

obligatorio

string

/^cert_[a-z0-9]{24,}$/

revision

obligatorio

integer

>= 1

status

obligatorio

string

Valor permitido: in_progress

path

obligatorio

Cualquiera de:

string

string

Valor permitido: own_software

string

string

Valor permitido: external_software

software

obligatorio

object

name

obligatorio

string

>= 1 characters <= 128 characters

version

obligatorio

string

>= 1 characters <= 64 characters

dgiiProvider

obligatorio

Cualquiera de:

object

object

rnc

obligatorio

string

/^[0-9]{9}$/

name

obligatorio

string

>= 1 characters <= 128 characters

null

null

phase

obligatorio

Cualquiera de:

string

string

Valor permitido: preparation

string

string

Valor permitido: application

string

string

Valor permitido: tests

string

string

Valor permitido: authorization

receiver

obligatorio

La única dirección por la que la DGII y otros emisores llegan al negocio, en certificación y en producción.

object

host

obligatorio

La dirección de recepción de Timbro, tal como la piden las casillas de la DGII, por ejemplo ecf.timbro.do. El negocio la escribe en Recepción, Aprobación comercial y Autenticación, en la postulación y en los pasos 7 y 12.

string

>= 1 characters

requirements

obligatorio

Array<object>

Lo que falta, quién lo resuelve y qué pasos esperan por eso. Desde el paso 12, Timbro recibe en producción los documentos del negocio; un requisito production_reception_* detiene el paso 12 hasta que eso ocurra. Volver a informar o declarar el paso 12 lo intenta de nuevo cuando lo hace una persona propietaria o una clave de administrador; si el requisito está a cargo del equipo de Timbro, espera a que el equipo lo resuelva.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: invoices_not_requested

string

string

Valor permitido: fiscal_details_incomplete

string

string

Valor permitido: certification_binding_required

string

string

Valor permitido: certification_certificate_required

string

string

Valor permitido: provider_eligibility_unverified

string

string

Valor permitido: certification_test_set_processing_unavailable

string

string

Valor permitido: certification_provider_acceptance_pending

string

string

Valor permitido: production_reception_certificate_required

string

string

Valor permitido: production_reception_integration_required

string

string

Valor permitido: production_reception_held_elsewhere

string

string

Valor permitido: production_reception_not_started

string

string

Valor permitido: production_reception_owner_required

string

string

Valor permitido: production_reception_receiver_missing

string

string

Valor permitido: production_reception_operator_review

string

string

Valor permitido: production_reception_already_filed

owner

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

string

string

Valor permitido: operator

blocks

obligatorio

Array

<= 4 items

field

string

actions

obligatorio

Lo que puede hacer quien llama ahora. start_production_reception aparece cuando informar el paso 12 puede pedirle a Timbro que reciba en producción los documentos del negocio: para una persona propietaria o una clave de administrador, porque eso crea el vínculo de producción. sign_portal_document aparece solo cuando el Timbro de este despliegue firma documentos del portal de la DGII, existe el vínculo de certificación y quien llama confirma por sí mismo: una persona o una clave de administrador, no un agente. run_test_set aparece en las mismas condiciones cuando el Timbro de este despliegue ejecuta archivos de pruebas de certificación.

Array

progress

obligatorio

Cualquiera de:

BusinessCertificationProgress

Último paso DGII que declaró el negocio. Los pasos anteriores se dan por completados para que la secuencia avance, y quedan como informados por el negocio. Una declaración nunca verifica un paso ni da acceso al modo en vivo.

object

dgiiStep

obligatorio

Cualquiera de:

number

number

Valor permitido: 1

number

number

Valor permitido: 2

number

number

Valor permitido: 3

number

number

Valor permitido: 4

number

number

Valor permitido: 5

number

number

Valor permitido: 6

number

number

Valor permitido: 7

number

number

Valor permitido: 8

number

number

Valor permitido: 9

number

number

Valor permitido: 10

number

number

Valor permitido: 11

number

number

Valor permitido: 12

number

number

Valor permitido: 13

number

number

Valor permitido: 14

number

number

Valor permitido: 15

postulationSoftware

obligatorio

Cualquiera de:

object

Programa que el negocio indicó en su postulación ante la DGII. name solo se acepta cuando kind es other.

object

kind

obligatorio

Cualquiera de:

string

string

Valor permitido: timbro

string

string

Valor permitido: other

string

string

Valor permitido: unknown

name

string

>= 1 characters <= 80 characters /^[^\p{C}]*$/

null

null

reportedAt

obligatorio

string format: date-time

null

null

entryKit

obligatorio

Array<object>

<= 5 items

Algo que el paso actual necesita del negocio, con la acción que lo completa. service_urls_in_dgii pide escribir la dirección de recepción en las casillas de la DGII en el paso 1, desde el paso 7 y desde el paso 12, y queda en done solo después de que el negocio informe ese paso desde Timbro. postulation_provider pide al negocio con la ruta external_software escribir en su postulación a INDEXA SRL como proveedor de servicios de facturación electrónica.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: signing_certificate

string

string

Valor permitido: service_urls

string

string

Valor permitido: service_urls_in_dgii

string

string

Valor permitido: postulation_software

string

string

Valor permitido: postulation_provider

state

obligatorio

Cualquiera de:

string

string

Valor permitido: done

string

string

Valor permitido: todo

string

string

Valor permitido: not_needed

action

obligatorio

Cualquiera de:

unknown

Cualquiera de:

string

string

Valor permitido: import_certificate

string

string

Valor permitido: copy_service_urls

string

string

Valor permitido: enter_service_urls_in_dgii

string

string

Valor permitido: confirm_software_with_dgii

string

string

Valor permitido: enter_postulation_provider_in_dgii

null

null

steps

obligatorio

Array<object>

>= 15 items <= 15 items

Un paso oficial de la DGII. basis indica de dónde viene su estado: declared_progress para un paso anterior al paso DGII declarado, business_report para un resultado informado y null cuando no hay nada registrado.

object

number

obligatorio

Cualquiera de:

number

number

Valor permitido: 1

number

number

Valor permitido: 2

number

number

Valor permitido: 3

number

number

Valor permitido: 4

number

number

Valor permitido: 5

number

number

Valor permitido: 6

number

number

Valor permitido: 7

number

number

Valor permitido: 8

number

number

Valor permitido: 9

number

number

Valor permitido: 10

number

number

Valor permitido: 11

number

number

Valor permitido: 12

number

number

Valor permitido: 13

number

number

Valor permitido: 14

number

number

Valor permitido: 15

code

obligatorio

string

>= 1 characters

title

obligatorio

string

>= 1 characters

actor

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

status

obligatorio

Cualquiera de:

string

string

Valor permitido: blocked

string

string

Valor permitido: action_required

string

string

Valor permitido: awaiting_dgii

string

string

Valor permitido: reported

string

string

Valor permitido: verified

basis

obligatorio

Cualquiera de:

unknown

Cualquiera de:

string

string

Valor permitido: timbro_executed

string

string

Valor permitido: declared_progress

string

string

Valor permitido: business_report

string

string

Valor permitido: service_observed

null

null

evidence

obligatorio

Array<object>

Resultado DGII informado por el negocio. Queda como informado: solo una respuesta de la DGII que Timbro reciba puede verificar un paso.

object

id

obligatorio

string

>= 1 characters

outcome

obligatorio

Cualquiera de:

string

string

Valor permitido: submitted

string

string

Valor permitido: approved

string

string

Valor permitido: rejected

string

string

Valor permitido: needs_correction

verification

obligatorio

Cualquiera de:

string

string

Valor permitido: user_reported

reference

obligatorio

Cualquiera de:

string

string

<= 255 characters

null

null

createdAt

obligatorio

string format: date-time

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

Idempotent-Replayed

string

Valor permitido: true

true cuando esta respuesta repite el resultado guardado de una solicitud anterior con la misma clave de idempotencia (Idempotency-Key).

201

201

Preparación de la certificación y avance ante la DGII que informó el negocio autenticado. Nada de esto da acceso al modo en vivo.

Media typeapplication/json

Campos y códigos de la respuesta

discriminator: status

BusinessCertificationNotStarted

object

object

obligatorio

string

Valor permitido: business_certification

status

obligatorio

string

Valor permitido: not_started

requirements

obligatorio

Array<object>

Lo que falta, quién lo resuelve y qué pasos esperan por eso. Desde el paso 12, Timbro recibe en producción los documentos del negocio; un requisito production_reception_* detiene el paso 12 hasta que eso ocurra. Volver a informar o declarar el paso 12 lo intenta de nuevo cuando lo hace una persona propietaria o una clave de administrador; si el requisito está a cargo del equipo de Timbro, espera a que el equipo lo resuelva.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: invoices_not_requested

string

string

Valor permitido: fiscal_details_incomplete

string

string

Valor permitido: certification_binding_required

string

string

Valor permitido: certification_certificate_required

string

string

Valor permitido: provider_eligibility_unverified

string

string

Valor permitido: certification_test_set_processing_unavailable

string

string

Valor permitido: certification_provider_acceptance_pending

string

string

Valor permitido: production_reception_certificate_required

string

string

Valor permitido: production_reception_integration_required

string

string

Valor permitido: production_reception_held_elsewhere

string

string

Valor permitido: production_reception_not_started

string

string

Valor permitido: production_reception_owner_required

string

string

Valor permitido: production_reception_receiver_missing

string

string

Valor permitido: production_reception_operator_review

string

string

Valor permitido: production_reception_already_filed

owner

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

string

string

Valor permitido: operator

blocks

obligatorio

Array

<= 4 items

field

string

availablePaths

obligatorio

Array

>= 1 items

recommendedPath

obligatorio

Cualquiera de:

string

string

Valor permitido: own_software

string

string

Valor permitido: external_software

actions

obligatorio

Array

<= 1 items

BusinessCertificationInProgress

object

object

obligatorio

string

Valor permitido: business_certification

id

obligatorio

string

/^cert_[a-z0-9]{24,}$/

revision

obligatorio

integer

>= 1

status

obligatorio

string

Valor permitido: in_progress

path

obligatorio

Cualquiera de:

string

string

Valor permitido: own_software

string

string

Valor permitido: external_software

software

obligatorio

object

name

obligatorio

string

>= 1 characters <= 128 characters

version

obligatorio

string

>= 1 characters <= 64 characters

dgiiProvider

obligatorio

Cualquiera de:

object

object

rnc

obligatorio

string

/^[0-9]{9}$/

name

obligatorio

string

>= 1 characters <= 128 characters

null

null

phase

obligatorio

Cualquiera de:

string

string

Valor permitido: preparation

string

string

Valor permitido: application

string

string

Valor permitido: tests

string

string

Valor permitido: authorization

receiver

obligatorio

La única dirección por la que la DGII y otros emisores llegan al negocio, en certificación y en producción.

object

host

obligatorio

La dirección de recepción de Timbro, tal como la piden las casillas de la DGII, por ejemplo ecf.timbro.do. El negocio la escribe en Recepción, Aprobación comercial y Autenticación, en la postulación y en los pasos 7 y 12.

string

>= 1 characters

requirements

obligatorio

Array<object>

Lo que falta, quién lo resuelve y qué pasos esperan por eso. Desde el paso 12, Timbro recibe en producción los documentos del negocio; un requisito production_reception_* detiene el paso 12 hasta que eso ocurra. Volver a informar o declarar el paso 12 lo intenta de nuevo cuando lo hace una persona propietaria o una clave de administrador; si el requisito está a cargo del equipo de Timbro, espera a que el equipo lo resuelva.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: invoices_not_requested

string

string

Valor permitido: fiscal_details_incomplete

string

string

Valor permitido: certification_binding_required

string

string

Valor permitido: certification_certificate_required

string

string

Valor permitido: provider_eligibility_unverified

string

string

Valor permitido: certification_test_set_processing_unavailable

string

string

Valor permitido: certification_provider_acceptance_pending

string

string

Valor permitido: production_reception_certificate_required

string

string

Valor permitido: production_reception_integration_required

string

string

Valor permitido: production_reception_held_elsewhere

string

string

Valor permitido: production_reception_not_started

string

string

Valor permitido: production_reception_owner_required

string

string

Valor permitido: production_reception_receiver_missing

string

string

Valor permitido: production_reception_operator_review

string

string

Valor permitido: production_reception_already_filed

owner

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

string

string

Valor permitido: operator

blocks

obligatorio

Array

<= 4 items

field

string

actions

obligatorio

Lo que puede hacer quien llama ahora. start_production_reception aparece cuando informar el paso 12 puede pedirle a Timbro que reciba en producción los documentos del negocio: para una persona propietaria o una clave de administrador, porque eso crea el vínculo de producción. sign_portal_document aparece solo cuando el Timbro de este despliegue firma documentos del portal de la DGII, existe el vínculo de certificación y quien llama confirma por sí mismo: una persona o una clave de administrador, no un agente. run_test_set aparece en las mismas condiciones cuando el Timbro de este despliegue ejecuta archivos de pruebas de certificación.

Array

progress

obligatorio

Cualquiera de:

BusinessCertificationProgress

Último paso DGII que declaró el negocio. Los pasos anteriores se dan por completados para que la secuencia avance, y quedan como informados por el negocio. Una declaración nunca verifica un paso ni da acceso al modo en vivo.

object

dgiiStep

obligatorio

Cualquiera de:

number

number

Valor permitido: 1

number

number

Valor permitido: 2

number

number

Valor permitido: 3

number

number

Valor permitido: 4

number

number

Valor permitido: 5

number

number

Valor permitido: 6

number

number

Valor permitido: 7

number

number

Valor permitido: 8

number

number

Valor permitido: 9

number

number

Valor permitido: 10

number

number

Valor permitido: 11

number

number

Valor permitido: 12

number

number

Valor permitido: 13

number

number

Valor permitido: 14

number

number

Valor permitido: 15

postulationSoftware

obligatorio

Cualquiera de:

object

Programa que el negocio indicó en su postulación ante la DGII. name solo se acepta cuando kind es other.

object

kind

obligatorio

Cualquiera de:

string

string

Valor permitido: timbro

string

string

Valor permitido: other

string

string

Valor permitido: unknown

name

string

>= 1 characters <= 80 characters /^[^\p{C}]*$/

null

null

reportedAt

obligatorio

string format: date-time

null

null

entryKit

obligatorio

Array<object>

<= 5 items

Algo que el paso actual necesita del negocio, con la acción que lo completa. service_urls_in_dgii pide escribir la dirección de recepción en las casillas de la DGII en el paso 1, desde el paso 7 y desde el paso 12, y queda en done solo después de que el negocio informe ese paso desde Timbro. postulation_provider pide al negocio con la ruta external_software escribir en su postulación a INDEXA SRL como proveedor de servicios de facturación electrónica.

object

code

obligatorio

Cualquiera de:

string

string

Valor permitido: signing_certificate

string

string

Valor permitido: service_urls

string

string

Valor permitido: service_urls_in_dgii

string

string

Valor permitido: postulation_software

string

string

Valor permitido: postulation_provider

state

obligatorio

Cualquiera de:

string

string

Valor permitido: done

string

string

Valor permitido: todo

string

string

Valor permitido: not_needed

action

obligatorio

Cualquiera de:

unknown

Cualquiera de:

string

string

Valor permitido: import_certificate

string

string

Valor permitido: copy_service_urls

string

string

Valor permitido: enter_service_urls_in_dgii

string

string

Valor permitido: confirm_software_with_dgii

string

string

Valor permitido: enter_postulation_provider_in_dgii

null

null

steps

obligatorio

Array<object>

>= 15 items <= 15 items

Un paso oficial de la DGII. basis indica de dónde viene su estado: declared_progress para un paso anterior al paso DGII declarado, business_report para un resultado informado y null cuando no hay nada registrado.

object

number

obligatorio

Cualquiera de:

number

number

Valor permitido: 1

number

number

Valor permitido: 2

number

number

Valor permitido: 3

number

number

Valor permitido: 4

number

number

Valor permitido: 5

number

number

Valor permitido: 6

number

number

Valor permitido: 7

number

number

Valor permitido: 8

number

number

Valor permitido: 9

number

number

Valor permitido: 10

number

number

Valor permitido: 11

number

number

Valor permitido: 12

number

number

Valor permitido: 13

number

number

Valor permitido: 14

number

number

Valor permitido: 15

code

obligatorio

string

>= 1 characters

title

obligatorio

string

>= 1 characters

actor

obligatorio

Cualquiera de:

string

string

Valor permitido: merchant

string

string

Valor permitido: dgii

string

string

Valor permitido: timbro

status

obligatorio

Cualquiera de:

string

string

Valor permitido: blocked

string

string

Valor permitido: action_required

string

string

Valor permitido: awaiting_dgii

string

string

Valor permitido: reported

string

string

Valor permitido: verified

basis

obligatorio

Cualquiera de:

unknown

Cualquiera de:

string

string

Valor permitido: timbro_executed

string

string

Valor permitido: declared_progress

string

string

Valor permitido: business_report

string

string

Valor permitido: service_observed

null

null

evidence

obligatorio

Array<object>

Resultado DGII informado por el negocio. Queda como informado: solo una respuesta de la DGII que Timbro reciba puede verificar un paso.

object

id

obligatorio

string

>= 1 characters

outcome

obligatorio

Cualquiera de:

string

string

Valor permitido: submitted

string

string

Valor permitido: approved

string

string

Valor permitido: rejected

string

string

Valor permitido: needs_correction

verification

obligatorio

Cualquiera de:

string

string

Valor permitido: user_reported

reference

obligatorio

Cualquiera de:

string

string

<= 255 characters

null

null

createdAt

obligatorio

string format: date-time

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

Idempotent-Replayed

string

Valor permitido: true

true cuando esta respuesta repite el resultado guardado de una solicitud anterior con la misma clave de idempotencia (Idempotency-Key).

400

400

No se pudo entender la solicitud.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "No se pudo entender la solicitud.",
  "status": 400,
  "code": "parameter_missing",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: parameter_missing parameter_invalid request_body_malformed

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 400

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

401

401

La credencial falta, tiene un formato incorrecto o ya no es válida.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La credencial falta, tiene un formato incorrecto o ya no es válida.",
  "status": 401,
  "code": "person_session_missing",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: person_session_missing api_key_missing api_key_invalid checkout_token_invalid checkout_token_expired

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 401

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

403

403

La credencial es válida, pero no tiene permiso para realizar esta operación.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La credencial es válida, pero no tiene permiso para realizar esta operación.",
  "status": 403,
  "code": "operation_not_permitted",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: operation_not_permitted

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 403

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

404

404

Ningún endpoint sirve este método y ruta, o no existe un recurso con este identificador dentro del alcance del solicitante.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "Ningún endpoint sirve este método y ruta, o no existe un recurso con este identificador dentro del alcance del solicitante.",
  "status": 404,
  "code": "business_not_found",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_not_found

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 404

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

409

409

La solicitud entra en conflicto con el estado actual del recurso o con una solicitud anterior que usó la misma clave de idempotencia (Idempotency-Key).

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La solicitud entra en conflicto con el estado actual del recurso o con una solicitud anterior que usó la misma clave de idempotencia (`Idempotency-Key`).",
  "status": 409,
  "code": "business_certification_path_unavailable",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_certification_path_unavailable business_certification_requirements_unmet idempotency_key_reused idempotency_request_in_progress idempotency_key_expired

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 409

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

Retry-After

string

/^[0-9]+$/

Segundos que debes esperar antes de repetir esta solicitud o volver a consultar el recurso.

413

413

El cuerpo de la solicitud es más grande de lo que acepta este endpoint.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "El cuerpo de la solicitud es más grande de lo que acepta este endpoint.",
  "status": 413,
  "code": "request_body_too_large",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: request_body_too_large

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 413

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

415

415

El cuerpo de la solicitud tiene un tipo de contenido que este endpoint no acepta.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "El cuerpo de la solicitud tiene un tipo de contenido que este endpoint no acepta.",
  "status": 415,
  "code": "unsupported_media_type",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: unsupported_media_type

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 415

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

500

500

La solicitud no pudo completarse. Recupera el resultado con la referencia guardada o repite la solicitud con la misma clave de idempotencia.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "La solicitud no pudo completarse. Recupera el resultado con la referencia guardada o repite la solicitud con la misma clave de idempotencia.",
  "status": 500,
  "code": "internal_error",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: internal_error

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 500

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.

503

503

Un servicio requerido no está disponible temporalmente. Inténtalo de nuevo con la misma referencia o la misma clave de idempotencia.

Media typeapplication/problem+json

Ejemplo

{
  "type": "about:blank",
  "title": "Un servicio requerido no está disponible temporalmente. Inténtalo de nuevo con la misma referencia o la misma clave de idempotencia.",
  "status": 503,
  "code": "business_fiscal_setup_unavailable",
  "requestId": "request_000000000000000000000001"
}

Campos y códigos de la respuesta

Detalles de problema RFC 9457. Cada fallo de esta API es uno de estos objetos y cada operación limita code al subconjunto que puede emitir.

object

code

obligatorio

Código estable legible por máquinas. Toma decisiones con este código, nunca con title.

string

Valores permitidos: business_fiscal_setup_unavailable

requestId

obligatorio

string

status

obligatorio

integer format: int32

>= 400 <= 599

Valor permitido: 503

title

obligatorio

string

type

obligatorio

string

Valores permitidos: about:blank

Campos opcionales

detail

string

invoiceId

Solo aparece si la solicitud rechazada produjo una operación fiscal.

string

issuanceBlockers

Solo aparece cuando las reglas oficiales de emisión rechazan la emisión.

Array<string>

Valores permitidos: invalid_request unsupported_protocol unsupported_rules_version invalid_resolved_facts numbering_verifier_missing numbering_mode_not_enabled document_type_not_recognized sequence_missing sequence_not_observed_on_effective_date sequence_suspended sequence_cancelled sequence_superseded sequence_exhausted sequence_conflicting sequence_document_type_mismatch sequence_rejected_by_dgii sequence_expired sequence_range_overlap fiscal_number_capacity_exhausted invalid_fiscal_number fiscal_number_outside_authorized_range fiscal_number_before_verified_floor sequence_expiration_mismatch

problems

Solo aparece cuando el rechazo señala un valor incluido en la solicitud.

Array<object>

Un problema público estable del documento, guardado para una admisión rechazada.

object

code

obligatorio

string

message

obligatorio

string

path

obligatorio

string

Cabeceras

request-id

obligatorio

string

Identifica esta solicitud. Indícalo cuando contactes a soporte.