Register NO VERIFACTU backup-restore event (canonical command endpoint)

POST/no-verifactu/events/restore-registrations

Request body

requiredapplication/json

detailsstring

Optional free-text description of the backup restore (stored as OtrosDatosEvento).

max length 500

Responses

201Registers a backup restore (TipoEvento 07)

correlationIdstring

Correlation ID for tracking the request

dataCreateEventDataDtorequired

Show properties

fechaHoraHusoGenEventostringrequired

FechaHoraHusoGenEvento (ISO 8601 con zona)

huellaEventostringrequired

HuellaEvento (SHA-256 hex en mayúsculas)

tipoEventostringrequired

TipoEvento codificado según EventosSIF

uuidstring<uuid>required

Unique identifier (UUID) of the stored event

successbooleanrequired

400

correlationIdstringrequired

messagestringrequired

pathstringrequired

statusCodenumberrequired

successbooleanrequired

timestampstringrequired

422

correlationIdstringrequired

errorDetailsobject

Present only when the error comes from VeriFactu submission

Show properties

verifactuErrorVerifactuErrorrequired

Show properties

causastring

Root cause of the error

codigoErrorRegistrostring

descripcionErrorRegistrostring

errorTypestringrequired

Allowed:ADMISSIBLEINADMISSIBLE

messagestring

Brief error message describing the issue

registroDuplicadoobject

Información del registro ya existente cuando AEAT rechaza por duplicidad

Show properties

codigoErrorRegistrostring

Código de error del registro duplicado almacenado en AEAT, si aplica

descripcionErrorRegistrostring

Descripción del error del registro duplicado almacenado en AEAT, si aplica

estadoRegistroDuplicadostring

Estado del registro duplicado almacenado en AEAT (Correcta, AceptadaConErrores, Anulada)

idPeticionRegistroDuplicadostring

IdPeticion asociado a la factura registrada previamente en AEAT (solo se informa si el rechazo es por duplicidad)

solucionstring

Detailed solution or recommended action to resolve the error

subsanableboolean

Indicates whether the error is correctable/recoverable through subsanation (correction) process

messagestringrequired

pathstringrequired

statusCodenumberrequired

successbooleanrequired

timestampstringrequired

500

correlationIdstringrequired

messagestringrequired

pathstringrequired

statusCodenumberrequired

successbooleanrequired

timestampstringrequired

Request

curl -X POST "https://api.multifactu.com/no-verifactu/events/restore-registrations" \
  -H "Content-Type: application/json" \
  -d '{
  "details": "Restore from nightly backup 2026-06-13"
}'

const response = await fetch("https://api.multifactu.com/no-verifactu/events/restore-registrations", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "details": "Restore from nightly backup 2026-06-13"
})
});

import requests

response = requests.post(
    "https://api.multifactu.com/no-verifactu/events/restore-registrations",
    headers={
        "Content-Type": "application/json"
    },
    json={
  "details": "Restore from nightly backup 2026-06-13"
},
)

Response

{
  "correlationId": "123e4567-e89b-12d3-a456-426614174000",
  "data": {
    "fechaHoraHusoGenEvento": "2024-01-01T19:20:30+01:00",
    "huellaEvento": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "tipoEvento": "01",
    "uuid": "bcda84ec-a5a7-4af3-a8fa-3c754b32711a"
  },
  "success": true
}

{
  "correlationId": "xyz",
  "message": "series is required when number is provided",
  "path": "/v1/verifactu/invoices/search",
  "statusCode": 400,
  "success": false,
  "timestamp": "2025-12-21T12:10:46.668Z"
}

{
  "correlationId": "xyz",
  "errorDetails": {
    "verifactuError": {
      "codigoErrorRegistro": "3000",
      "descripcionErrorRegistro": "Registro de facturación duplicado.",
      "errorType": "INADMISSIBLE"
    }
  },
  "message": "series is required when number is provided",
  "path": "/v1/verifactu/invoices/search",
  "statusCode": 422,
  "success": false,
  "timestamp": "2025-12-21T12:10:46.668Z"
}