Procesar una recepción

POST /api/receptions/v4

Este endpoint permite procesar una recepción ante el Ministerio de Hacienda.

La recepción es el proceso de confirmación de aceptación o rechazo de los documentos electrónicos emitidos hacia el obligado tributario.

Aquí se especifica la clase de salida: ProcessReceptionResponse

Parámetros

Aquí se especifica la clase de entrada en su totalidad: ProcessReceptionRequest

includeData (bool) (opcional)

Este parámetro se puede enviar por medio del query string. Su valor por defecto es false. Le indica al endpoint si debe devolver valores “data”, o sea, si debe devolver en este endpoint el XML creado y firmado.

Esto permite que los clientes que consumen el API pueden elegir entre obtener los XML directos en las respuestas o obtenerlos después en llamadas individuales.

Respuestas Esperadas

HTTP 200 OK

La recepción ha sido procesado exitosamente y se ha enviado al Ministerio de Hacienda.

HTTP 400 Bad Request

Los parámetros de entrada presentan errores, ver la documentación de validaciones.

Ejemplo:

    {
        "statusCode": 400,
        "message": "One or more errors occurred!",
        "errors": {
            "processReceptionRequest.Xml": [
                "La versión de facturacion del documento no es compatible, solo se procesan recepciones de 4.3 y 4.4."
            ]
        }
    }

HTTP 500 Internal Server Error

Ocurrio un error interno o hubo un problema en la comunicación con Hacienda.

Ejemplo de respuesta con error con descripción completa:

    {
        "clave_recepcion": "50612082500310140926102000001050000000016119079365",
        "numero_recepcion": "02000001050000000016",
        "consecutivo_recepcion": "16",
        "clave_documento": "50612082500310137293502000001010000000285119079365",
        "numero_documento": "02000001010000000285",
        "consecutivo_documento": "285",
        "estado": "05",
        "estado_humanizado": "NotSendYet",
        "resolucion": 1,
         "xml": "",
        "mensaje_api": "Las credenciales de Hacienda utilizadas no son correctas.",
        "mensaje_api_key": "InvalidCredentials"
    }

Ejemplo de respuesta con error interno muy grave:

    {
        "error": "Error interno. Disculpas. Puede reportar el error suministrando este código: 326d96d9-5200-4a64-a84d-986e99f62c5f"
    }

Ejemplo

Llamada

    {
        "resolucion": 1,
        "detalle": "Aceptado",
        "clave_recepcion": "50626062500310140926102000001050000000001119079365",
        "xml": "PD94bWwgdmVy..."
    }

Respuesta

    {
        "clave_recepcion": "50612082500310140926102000001050000000016119079365",
        "numero_recepcion": "02000001050000000016",
        "consecutivo_recepcion": "16",
        "clave_documento": "50612082500310137293502000001010000000285119079365",
        "numero_documento": "02000001010000000285",
        "consecutivo_documento": "285",
        "estado": "04",
        "estado_humanizado": "Sent",
        "resolucion": 1,
         "xml": "",
        "mensaje_api": "",
        "mensaje_api_key": ""
    }