Solicitar acceso

Envía el set de pruebas de habilitación de la DIAN

POST/api/v1/account/test-set

Solo en habilitación y con el TestSetId en el perfil del emisor (test_set_id o payroll_test_set_id). factuROA crea los rangos de prueba que faltan (SETP de la DIAN para la factura; NC, ND, NE y NAE), envía las facturas (o nóminas) y, cuando quedan finales, las notas crédito y débito (o nóminas de ajuste) sobre las aceptadas. Las cantidades son las que muestra el portal de la DIAN; sin ellas, 30 facturas, 10 notas crédito y 10 débito (o 4 nóminas y 4 ajustes). Los impuestos siguen el emisor (IVA 19 %, INC 8 % o ambos) y cada tercera factura usa price_includes_tax. Un set a la vez por tipo (409 error.test_set.running). Seguir con GET.

Cuerpo de la petición application/json

  • kindstringobligatorio

    Valores: invoicing · payroll

  • documentsinteger

    Facturas o nóminas (1 a 100)

  • adjustmentsinteger

    Notas crédito o nóminas de ajuste

  • debit_adjustmentsinteger

    Notas débito (solo invoicing)

Respuestas

202Set en curso
  • idstring · uuid
  • kindstring

    Valores: invoicing · payroll

  • statusstring

    completed: todos aceptados; la aprobación final la da la DIAN en su portal

    Valores: running · completed · failed

  • phasestring

    Valores: documents · adjustments · done

  • documentsobject
    + Ver 5 campos− Ocultar 5 campos
    • plannedinteger
    • sentinteger
    • acceptedinteger
    • rejectedinteger
    • pendinginteger
  • adjustmentsobject
    + Ver 5 campos− Ocultar 5 campos
    • plannedinteger
    • sentinteger
    • acceptedinteger
    • rejectedinteger
    • pendinginteger
  • errorstring
  • created_atstring · date-time
  • finished_atstring · date-time
  • itemsarray<object>
    + Ver 8 campos− Ocultar 8 campos
    • idstring · uuid
    • external_idstring
    • document_typestring
    • full_numberstring
    • statusstring
    • dian_status_descriptionstring
    • dian_errorsarray<string>
    • errorstring
400Datos inválidos (details trae los campos)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring
401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring
409Conflicto con el estado actual (p. ej. documento referenciado no aceptado, rango agotado)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring