{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "cliente": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "nombre": {
          "type": "string"
        },
        "primer_apellido": {
          "type": "string"
        },
        "segundo_apellido": {
          "type": "string"
        },
        "razon_social": {
          "type": "string",
          "description": "Nombre legal de la empresa. Obligatorio para persona jurídica."
        },
        "identificador": {
          "type": "string",
          "description": "NIF o NIE válido del titular, coherente con el tipo de persona."
        },
        "id_tipo_persona": {
          "type": [
            "integer",
            "string"
          ],
          "description": "1 para persona física; 2 para persona jurídica. Debe corresponder a la ruta residencial o empresa."
        },
        "id_tipo_identificador": {
          "type": [
            "integer",
            "string"
          ],
          "description": "Identificador de maestra: 3 DNI, 4 NIF, 8 NIE. Consulte /maestras/gas."
        },
        "direccion": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "pais": {
              "type": "string"
            },
            "calle": {
              "type": "string"
            },
            "numero_finca": {
              "type": "string"
            },
            "codigo_postal": {
              "type": "string"
            },
            "aclarador_finca": {
              "type": "string"
            },
            "escalera": {
              "type": "string"
            },
            "piso": {
              "type": "string"
            },
            "puerta": {
              "type": "string"
            },
            "portal": {
              "type": "string"
            },
            "id_municipio": {
              "type": [
                "integer",
                "string"
              ]
            },
            "id_provincia": {
              "type": [
                "integer",
                "string"
              ]
            },
            "tipo_via_codigo": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "pais",
            "calle",
            "numero_finca",
            "codigo_postal",
            "id_municipio",
            "id_provincia",
            "tipo_via_codigo"
          ],
          "description": "Domicilio del titular. Los IDs de provincia y municipio deben pertenecer a la misma relación geográfica."
        },
        "prefijo_1": {
          "type": "string"
        },
        "telefono_1": {
          "type": "string"
        },
        "correo_electronico": {
          "type": "string"
        },
        "email_factura": {
          "type": "string"
        },
        "idioma_plantilla": {
          "type": "string"
        },
        "envio_factura": {
          "type": "boolean"
        },
        "aviso_modificacion_precios": {
          "type": "boolean"
        },
        "autonomo": {
          "type": "boolean"
        },
        "es_firmante": {
          "type": "boolean"
        }
      },
      "required": [
        "identificador",
        "id_tipo_persona",
        "id_tipo_identificador",
        "direccion",
        "telefono_1",
        "correo_electronico"
      ],
      "allOf": [
        {
          "if": {
            "properties": {
              "id_tipo_persona": {
                "enum": [
                  2,
                  "2"
                ]
              }
            },
            "required": [
              "id_tipo_persona"
            ]
          },
          "then": {
            "required": [
              "razon_social"
            ],
            "properties": {
              "razon_social": {
                "type": "string",
                "minLength": 1
              }
            }
          },
          "else": {
            "required": [
              "nombre",
              "primer_apellido"
            ],
            "properties": {
              "nombre": {
                "type": "string",
                "minLength": 1
              },
              "primer_apellido": {
                "type": "string",
                "minLength": 1
              }
            }
          }
        }
      ],
      "description": "Titular del contrato: persona física o empresa."
    },
    "punto_suministro": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "cups": {
          "type": "string",
          "pattern": "^ES\\d{16}[A-Z]{2}[A-Z0-9]{0,2}$",
          "description": "CUPS de gas de 20 o 22 caracteres. Los dos caracteres de extensión no diferencian solicitudes del mismo suministro."
        },
        "pais": {
          "type": "string"
        },
        "calle": {
          "type": "string"
        },
        "numero_finca": {
          "type": "string"
        },
        "codigo_postal": {
          "type": "string"
        },
        "aclarador_finca": {
          "type": "string"
        },
        "escalera": {
          "type": "string"
        },
        "piso": {
          "type": "string"
        },
        "puerta": {
          "type": "string"
        },
        "portal": {
          "type": "string"
        },
        "tipo_via_codigo": {
          "type": "string"
        },
        "referencia_catastral": {
          "type": "string"
        },
        "municipio_id": {
          "type": [
            "integer",
            "string"
          ]
        },
        "provincia_id": {
          "type": [
            "integer",
            "string"
          ]
        },
        "telemedida": {
          "type": "boolean"
        },
        "consumo_anual_estimado": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 1
            },
            {
              "type": "string",
              "pattern": "^[0-9]*[1-9][0-9]*$"
            }
          ],
          "description": "Consumo aportado en kWh enteros positivos, sin decimales. Si también se informa en el contrato, ambos valores deben coincidir. Se conserva el valor aportado. Si falta en ambos objetos, se utiliza SIPS; solo el consumo del punto obtenido de SIPS se redondea al kWh más cercano (0,5 hacia arriba)."
        }
      },
      "required": [
        "cups",
        "pais",
        "calle",
        "numero_finca",
        "codigo_postal",
        "municipio_id",
        "provincia_id",
        "tipo_via_codigo",
        "telemedida"
      ],
      "description": "Datos del suministro. La dirección se informa directamente dentro de este objeto."
    },
    "contrato_suministro": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "iban": {
          "type": "string",
          "description": "IBAN español válido, sin espacios."
        },
        "bic_swift": {
          "type": "string"
        },
        "nombre_pago": {
          "type": "string"
        },
        "identificador_pago": {
          "type": "string"
        },
        "peaje_acceso": {
          "type": "string"
        },
        "periodicidad": {
          "type": "string"
        },
        "tipo_mandato": {
          "type": "string"
        },
        "frecuencia_pago": {
          "type": "string"
        },
        "tipo_dias_denuncia": {
          "type": "string"
        },
        "dias_meses_plazo_pago": {
          "type": "string"
        },
        "naturaleza_suministro": {
          "type": "string"
        },
        "tipo_inicio_info": {
          "type": "string"
        },
        "cnae_id": {
          "type": [
            "integer",
            "string"
          ],
          "description": "Identificador del catálogo CNAE de gas devuelto por /maestras/gas."
        },
        "modo_pago_id": {
          "type": [
            "integer",
            "string"
          ]
        },
        "id_tipo_identificador_pago": {
          "type": [
            "integer",
            "string"
          ]
        },
        "id_tipo_plazo_cobro": {
          "type": [
            "integer",
            "string"
          ]
        },
        "dias": {
          "type": "integer",
          "minimum": 0
        },
        "anyos": {
          "type": "integer",
          "minimum": 0
        },
        "meses": {
          "type": "integer",
          "minimum": 0,
          "description": "Duración en meses. Debe cumplir duracion_meses_min y duracion_meses_max de la tarifa elegida."
        },
        "dias_denuncia": {
          "type": "integer",
          "minimum": 0
        },
        "valor_dias_meses_plazo_pago": {
          "type": "integer",
          "minimum": 0
        },
        "telemedida": {
          "type": "boolean"
        },
        "planta_satelite": {
          "type": "boolean"
        },
        "prorroga_tacita": {
          "type": "boolean",
          "description": "Debe ser true cuando la tarifa devuelve prorroga_tacita_config=forzar_si."
        },
        "vivienda_habitual": {
          "type": "boolean"
        },
        "fecha_fija_fin_contrato": {
          "type": "boolean"
        },
        "inicio_fecha_activacion": {
          "type": "boolean"
        },
        "marcar_revisado": {
          "type": "boolean",
          "description": "Booleano opcional que indica si Neuro marca el contrato como revisado. Se conserva true o false cuando se informa; HERS no lo añade si se omite. No indica que el contrato esté firmado ni sustituye la firma."
        },
        "info_alta": {
          "type": "string",
          "enum": [
            "si",
            "no",
            "no lo se"
          ],
          "description": "si para cambio de comercializadora; no para alta nueva."
        },
        "info_titular": {
          "type": "string",
          "enum": [
            "si",
            "no",
            "no lo se"
          ],
          "description": "Cambio de comercializadora: no si se mantiene el titular; si cuando cambia. En alta nueva: no lo se."
        },
        "info_caudal": {
          "type": "string",
          "enum": [
            "si",
            "no",
            "no lo se"
          ],
          "description": "Debe ser no lo se. La modificación de caudal no está disponible en estas rutas."
        },
        "fecha_inicio_info": {
          "type": "string",
          "format": "date",
          "description": "Fecha de inicio solicitada (AAAA-MM-DD). Obligatoria con tipo_inicio_info=fecha_fija; debe omitirse con cuanto_antes."
        },
        "fecha_fin": {
          "type": "string",
          "format": "date",
          "description": "Fecha final aportada (AAAA-MM-DD). No puede ser anterior a fecha_inicio_info. HERS no la calcula a partir de la duración ni la añade si se omite."
        },
        "fecha_firma": {
          "type": "string",
          "format": "date"
        },
        "consumo_anual_estimado": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 1
            },
            {
              "type": "string",
              "pattern": "^[0-9]*[1-9][0-9]*$"
            }
          ],
          "description": "Consumo aportado en kWh enteros positivos, sin decimales. Tiene prioridad sobre SIPS y debe coincidir con el del punto si se informan ambos. Si falta en ambos objetos se utiliza SIPS; sin consumo en ninguna fuente se devuelve un error. Si SIPS informa el peaje, se conserva sin reclasificarlo por el consumo estimado. La comprobación del tramo se aplica al peaje aportado cuando no existe uno confirmado en SIPS."
        },
        "etiquetas_canal": {
          "type": "array",
          "items": {
            "type": [
              "integer",
              "string"
            ]
          }
        },
        "conceptos_formula_agente": {
          "type": "array",
          "maxItems": 2,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "abreviatura": {
                "enum": [
                  "FEE_CC_TF",
                  "FEE_CC_TV"
                ]
              },
              "valor": {
                "type": [
                  "number",
                  "string"
                ],
                "pattern": "^\\d+(\\.\\d+)?$"
              }
            },
            "required": [
              "abreviatura",
              "valor"
            ]
          },
          "description": "Márgenes sin impuestos: FEE_CC_TF en €/día y FEE_CC_TV en €/kWh. Hasta seis decimales; se envían separados del precio base."
        },
        "tarifas": {
          "type": "array",
          "minItems": 1,
          "maxItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "id_tarifa_precios": {
                "type": "integer",
                "minimum": 1
              },
              "precio_termino_fijo_personalizado": {
                "type": [
                  "number",
                  "string"
                ],
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              "precio_termino_variable_personalizado": {
                "type": [
                  "number",
                  "string"
                ],
                "pattern": "^\\d+(\\.\\d+)?$"
              },
              "unidades_termino_fijo_personalizado": {
                "const": "€/mes"
              },
              "unidades_termino_variable_personalizado": {
                "const": "€/kWh"
              }
            },
            "required": [
              "id_tarifa_precios"
            ]
          },
          "description": "Una tarifa de precios del canal. Consulte /tarifas/gas y /tarifas/gas/precios antes de contratar."
        },
        "impuestos_hidrocarburos": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "descripcion": {
                "type": "string"
              },
              "fecha_desde": {
                "type": "string",
                "format": "date"
              },
              "fecha_hasta": {
                "type": "string",
                "format": "date"
              },
              "valores": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "tipo": {
                      "type": "string",
                      "enum": [
                        "no_carburante",
                        "carburante"
                      ]
                    },
                    "porcentaje": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 100
                    },
                    "exencion_impuesto_hc": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "tipo",
                    "porcentaje",
                    "exencion_impuesto_hc"
                  ]
                }
              }
            },
            "required": [
              "descripcion",
              "fecha_desde",
              "fecha_hasta",
              "valores"
            ]
          },
          "description": "Periodos y reparto del impuesto. Los porcentajes de cada periodo deben sumar 100 y la fecha final no puede preceder a la inicial."
        }
      },
      "required": [
        "iban",
        "modo_pago_id",
        "frecuencia_pago",
        "naturaleza_suministro",
        "tarifas",
        "id_tipo_identificador_pago",
        "identificador_pago",
        "nombre_pago",
        "meses",
        "cnae_id",
        "info_alta",
        "info_titular",
        "info_caudal",
        "impuestos_hidrocarburos"
      ],
      "description": "Condiciones de contratación, cobro, tarifa, gestión e impuesto de hidrocarburos."
    },
    "contactos": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "contacto": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "nombre": {
                "type": "string"
              },
              "primer_apellido": {
                "type": "string"
              },
              "segundo_apellido": {
                "type": "string"
              },
              "razon_social": {
                "type": "string"
              },
              "identificador": {
                "type": "string"
              },
              "id_tipo_persona": {
                "type": [
                  "integer",
                  "string"
                ]
              },
              "id_tipo_identificador": {
                "type": [
                  "integer",
                  "string"
                ]
              },
              "tlf_firma": {
                "type": "string"
              },
              "email_firma": {
                "type": "string"
              },
              "id_canal_envio": {
                "type": [
                  "integer",
                  "string"
                ]
              },
              "email": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "type": "string",
                  "format": "email"
                }
              },
              "telefonos": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "numero": {
                      "type": "string"
                    },
                    "extension": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "numero"
                  ]
                }
              }
            },
            "required": [
              "nombre",
              "primer_apellido",
              "identificador",
              "id_tipo_persona",
              "id_tipo_identificador",
              "email"
            ]
          },
          "id_tipo_contacto": {
            "type": [
              "integer",
              "string"
            ]
          },
          "email_factura": {
            "type": "string"
          },
          "email_modificacion_precios": {
            "type": "string"
          },
          "envio_factura": {
            "type": "boolean"
          },
          "envio_factura_papel": {
            "type": "boolean"
          },
          "aviso_modificacion_precios": {
            "type": "boolean"
          }
        },
        "required": [
          "contacto",
          "id_tipo_contacto"
        ]
      },
      "description": "Contactos y destinatarios de firma. Una empresa requiere al menos un representante físico de tipo Firmante (id_tipo_contacto=1)."
    },
    "operacion": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "no_enviar_firma": {
          "type": "boolean",
          "default": false,
          "description": "true crea el contrato sin solicitar su firma. Si se omite o es false, se solicita la firma tras el alta aprobada."
        },
        "no_credit_check": {
          "type": "boolean",
          "default": false,
          "description": "true omite la evaluación de riesgo. Si se omite o es false, solo un resultado Aprobado permite crear el contrato."
        },
        "datos_suministro_aportados": {
          "type": "boolean",
          "default": false,
          "description": "Solo alta nueva sin SIPS, con consumo kWh, peaje, CNAE y dirección aportados por el cliente."
        },
        "canal_envio": {
          "type": "string",
          "enum": [
            "email",
            "sms",
            "email_otp"
          ],
          "description": "Para gas, omita este campo: el canal de firma se indica en contactos[].contacto.id_canal_envio. No se permite sobrescribirlo al solicitar firma."
        },
        "direcciones_firma": {
          "type": "string",
          "description": "Para gas, omita este campo: los destinatarios se indican en los contactos del contrato."
        },
        "id_grupo_tarifa": {
          "type": [
            "integer",
            "string"
          ],
          "pattern": "^[0-9]+$",
          "description": "Grupo devuelto por /tarifas/gas. Obligatorio si la tarifa elegida está disponible en varios grupos."
        },
        "fecha_precio": {
          "type": "string",
          "format": "date",
          "description": "Debe ser hoy. Un precio de otra jornada requiere revalidación."
        }
      }
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https://",
      "description": "URL HTTPS cuyo dominio debe estar autorizado. Su presencia activa el procesamiento asíncrono. Obligatoria en /contrato/gas/raw."
    },
    "callback_exec": {
      "type": "boolean",
      "default": true,
      "description": "Con callback_url, false conserva el procesamiento asíncrono pero suprime la entrega del resultado al callback."
    },
    "referencia_externa": {
      "type": "string",
      "maxLength": 255,
      "description": "Referencia de su sistema que se devuelve en el resultado para relacionar la solicitud."
    },
    "url_notificaciones_cambios_contrato": {
      "type": "string",
      "description": "No disponible para gas. Informar una URL devuelve HTTP 501; no confundir con callback_url, que comunica el resultado del alta."
    }
  },
  "required": [
    "cliente",
    "punto_suministro",
    "contrato_suministro",
    "contactos"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Solicitud de alta de un contrato de gas",
  "description": "Datos del titular, contactos, punto de suministro y condiciones del contrato. Cada solicitud corresponde a un suministro.",
  "$id": "https://webhooks.imaginaenergia.com/docs/contrato_gas.input.schema.json"
}
