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
Status | Title | Detail |
---|---|---|
460 | Se ha excedido el número máximo de cargas simultaneas |