iniciar_carga

Descripción

Inicia una transacción de subida de ficheros asociados a un procedimiento. En posteriores operaciones se asociarán las subidas de ficheros correspondientes a dicha transacción, componiendo la carga completa. Se permitirá un número máximo de 10 cargas simultáneas por empresa y procedimiento

Estructura de la url

Petición

Esta petición se debe enviar utilizando los métodos HTTP POST y HTTP PUT.

En el cuerpo de la petición contendrá un documento JSON con la siguiente estructura: 

• nifPresentador: Identificador que representa a la persona (física o jurídica) que presenta los ficheros.
• nifEmpresa: Identificador de la empresa a la que pertenecen los ficheros.
• idProcedimiento: Identificador del procedimiento al que están asociados los ficheros.
• fechaEfecto: Parámetro opcional. Fecha que identifica el periodo para el que se realiza la carga. (Opcional). 

Por defecto, permitirá un número máximo de 10 cargas simultáneas por empresa y procedimiento. 

Ejemplo documento JSON Petición

{
    "nifPresentador":"12345678Z",
    "nifEmpresa":"11111111H",
    "idProcedimiento": 12345,
    "fechaEfecto":"2015-01-31"
}

Respuesta

El cuerpo de la respuesta contendrá un documento JSON con los siguientes parámetros:

• uuidCarga: Identificador de la carga en formato UUID. Este identificador debe emplearse necesariamente en el resto de las operaciones asociadas a esta carga. 
• expiracionSegundos: Segundos para que caduque esta carga. Durante este tiempo es posible realizar operaciones sobre esta carga, incluida confirmar_carga. El valor por defecto es 172.800s (48h). En caso de alcanzar la caducidad sin la confirmación de la carga, se descartarán las operaciones, ficheros y datos asociados. 

Ejemplo deocument JSON Respuesta

{
    "uuidCarga":"550e8400-e29b-41d4-a716-446655440000",
    "expiracionSegundos": 172800
}

Errores específicos