technical article

Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints

17 de noviembre de 2026Updated: 17 de noviembre de 20268 min readVerificado
Cinn Song

Cinn Song

Founder & Chief Solutions Architect

Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints

Especifique explícitamente JSON o XML tanto para Solar Dataset Query V2 como para PVWatts V8; CSV solo está documentado para la búsqueda. Exija las coordenadas del emplazamiento, los datos de entrada del cálculo, la trazabilidad del archivo meteorológico y comprobaciones de aceptación específicas para cada endpoint. Considere cualquier exportación de cálculos en CSV como un entregable de la aplicación que debe especificarse por separado.

Resumen

Especifique explícitamente JSON o XML tanto para Solar Dataset Query V2 como para PVWatts V8; CSV solo está documentado para la búsqueda. Exija las coordenadas del emplazamiento, los datos de entrada del cálculo, la trazabilidad del archivo meteorológico y comprobaciones de aceptación específicas para cada endpoint. Considere cualquier exportación de cálculos en CSV como un entregable de la aplicación que debe especificarse por separado.

Puntos clave

  • JSON y XML están documentados para ambos endpoints; CSV solo figura para Solar Dataset Query V2.
  • Ambos endpoints requieren un formato de respuesta explícito y no documentan ningún formato predeterminado.
  • PVWatts V8 puede utilizar un file_id válido obtenido en la búsqueda; omita dataset al utilizar ese identificador.
  • Registre los detalles de la fuente meteorológica y la distancia, diferenciando el radio de búsqueda en millas de la distancia devuelta en metros.
  • Especifique los datos de entrada del cálculo, el intervalo temporal y las unidades: la energía mensual y la potencia horaria corresponden a campos de salida distintos.
  • Verifique los analizadores de ambos endpoints, la transferencia del archivo meteorológico, las advertencias y el tratamiento de entradas no válidas antes de la aceptación.

Especifique JSON o XML para la búsqueda de datos climáticos y los cálculos de producción fotovoltaica

Resumen: Especifique JSON o XML tanto para Solar Dataset Query V2 como para PVWatts V8. Ambos documentan estos formatos de respuesta; CSV solo figura para la búsqueda. Exija la selección explícita del formato, las coordenadas del emplazamiento, los datos de entrada del cálculo y la trazabilidad del archivo meteorológico. Verifique cada endpoint por separado antes de aceptar la integración.

1. Elija un formato compatible con ambos endpoints

Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints — Anatomía funcional detallada

Para una especificación de contratación que abarque la búsqueda de datos climáticos y los cálculos de producción fotovoltaica, exija un formato de respuesta común: JSON o XML. Solar Dataset Query V2 enumera json, xml y csv, mientras que PVWatts V8 enumera json y xml. Ambos describen format como obligatorio, sin un valor predeterminado. Sus URL de solicitud sitúan el formato seleccionado después de la versión del endpoint. Solar Dataset Query V2; PVWatts V8

La redacción contractual recomendada es: «La integración deberá solicitar explícitamente JSON tanto para la búsqueda como para el cálculo, o XML para ambos cuando lo requiera el sistema receptor. La compatibilidad con CSV para la búsqueda deberá especificarse por separado». Elija entre JSON y XML según el software receptor y los requisitos de aceptación del comprador. Las listas de formatos documentadas no establecen una ventaja de rendimiento para ninguna de las dos opciones.

CSV sigue siendo una opción documentada para la búsqueda. Sin embargo, su presencia en Solar Dataset Query V2 no demuestra que PVWatts V8 sea compatible con CSV. Si un licitador propone entregar los cálculos en CSV, pregunte si se trata de una exportación generada por la aplicación y exija una especificación de exportación independiente. No acepte la compatibilidad con un formato de búsqueda como verificación de la interfaz de cálculo.

2. Especifique la transferencia de la búsqueda al cálculo

Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints — Operación y mantenimiento detallados del sistema

Solar Dataset Query V2 requiere una clave de API, latitud, longitud y formato de respuesta. Devuelve información sobre los archivos climáticos disponibles, incluidos identificadores, coordenadas, distancia y fuente de los datos meteorológicos. Para un conjunto de datos sin resultados, la respuesta documentada contiene null y una advertencia. Se recomienda exigir que la aplicación conserve estas advertencias junto con el resultado de la búsqueda. Solar Dataset Query V2

PVWatts V8 acepta la latitud y longitud del emplazamiento o un file_id. Un file_id debe ser un identificador válido devuelto por Solar Dataset Query V2. Al especificar ese identificador, la documentación indica que no se debe enviar dataset. Para que la transferencia sea auditable, se recomienda registrar el identificador seleccionado en la búsqueda y enviarlo explícitamente al endpoint de cálculo. PVWatts V8

Los parámetros de búsqueda también deben tratarse explícitamente. La documentación de búsqueda expresa radius en millas, mientras que la distance devuelta está en metros. Indica que radius=0 encuentra las estaciones más cercanas independientemente de la distancia y que all=1 requiere un radio positivo. Aunque la solicitud del ejemplo combina un radio cero con all=1, la aceptación contractual debe seguir la regla del parámetro y probar un radio positivo al solicitar todas las estaciones. Solar Dataset Query V2

Se recomienda pedir al licitador que muestre el registro meteorológico seleccionado y su distancia antes de aprobar el cálculo. Una respuesta de búsqueda satisfactoria, por sí sola, no debe constituir la aceptación de ese registro por parte del comprador para el proyecto.

3. Defina los datos de entrada del cálculo y el significado de los resultados

Un formato de serialización común no sustituye la especificación del cálculo. PVWatts V8 requiere la potencia nominal, el tipo de módulo, las pérdidas del sistema, el tipo de configuración del campo fotovoltaico, la inclinación y el acimut, junto con la selección de la ubicación o del archivo climático y los parámetros de acceso a la API. Se recomienda exigir una relación de datos de entrada del proyecto que identifique cada valor enviado y distinga las selecciones deliberadas de los valores predeterminados documentados. PVWatts V8

Especifique también la granularidad de los resultados. PVWatts V8 proporciona resultados mensuales de forma predeterminada y acepta timeframe=hourly. Sus resultados mensuales de CA y CC son valores de energía en kWhac y kWhdc; los resultados horarios de CA y CC son valores de potencia en Wac y Wdc. Las matrices mensuales abarcan de enero a diciembre. Se recomienda incluir estos nombres de campo, unidades y orden en la hoja de aceptación de la interfaz. PVWatts V8

Para garantizar la trazabilidad meteorológica, solicite que se conserve station_info, incluida la fuente de los datos meteorológicos y el nombre del archivo de recurso solar. La respuesta documentada también incluye los datos de entrada recibidos, los errores, las advertencias, la versión del servicio y la información de la biblioteca SSC. Se recomienda almacenar la respuesta de cálculo pertinente junto con cada estimación revisada para que el comprador pueda examinar la configuración modelizada y su procedencia. PVWatts V8

4. Acepte la integración mediante comprobaciones específicas para cada endpoint

Se recomienda exigir que el licitador demuestre la búsqueda y el cálculo por separado en el formato seleccionado y, a continuación, demuestre la transferencia entre ambos. Compruebe los identificadores de búsqueda, las advertencias sobre conjuntos de datos sin resultados y el registro climático seleccionado. Para el cálculo, compruebe los datos de entrada enviados, la información de la estación devuelta, el intervalo temporal solicitado y las unidades de salida.

Exija comprobaciones independientes del analizador para cada endpoint, aunque ambos utilicen JSON o XML. La búsqueda describe los archivos climáticos disponibles; PVWatts devuelve resultados de simulación y metadatos del cálculo. Por tanto, un formato común debe ser una elección contractual acompañada de una correspondencia explícita entre campos. Solar Dataset Query V2; PVWatts V8

Ambos documentos describen HTTP 422 para parámetros ausentes o no válidos y remiten a los usuarios a la sección de errores de la respuesta. Se recomienda incluir un caso de entrada no válida en las pruebas de aceptación y verificar que la aplicación comunica el error en lugar de presentarlo como una estimación de producción. Ambos también establecen un límite de 1000 solicitudes por hora; pida al licitador que explique cómo la programación de solicitudes propuesta respeta ese límite. Solar Dataset Query V2; PVWatts V8

El alcance de la aceptación es una interfaz operativa de búsqueda y simulación. PVWatts V8 documenta resultados de producción prevista. Para una decisión de contratación que implique una generación garantizada del proyecto, solicite por separado las pruebas específicas del proyecto y las condiciones contractuales que respalden esa garantía.

Preguntas frecuentes

¿Debe el contrato exigir JSON o XML?

Exija cualquiera de los dos como formato común, seleccionado según el software receptor. Ambos endpoints documentan JSON y XML.

¿Se puede especificar CSV para ambas API?

CSV está documentado para Solar Dataset Query V2, pero no figura entre los formatos de respuesta de PVWatts V8. Especifique por separado cualquier exportación de cálculos en CSV generada por la aplicación.

¿Puede la integración omitir la selección del formato?

Ambos documentos indican que el formato es obligatorio y no enumeran ningún valor predeterminado. Exija una selección explícita en cada solicitud.

¿Cómo se puede seleccionar para el cálculo un archivo climático encontrado en la búsqueda?

Envíe su identificador válido de búsqueda como file_id de PVWatts V8. La documentación indica que no se debe enviar dataset junto con file_id.

¿Restringe radius=0 la búsqueda a la ubicación del proyecto?

No. Selecciona las estaciones más cercanas independientemente de la distancia. Examine la distancia devuelta antes de aprobar el registro meteorológico.

¿Qué ocurre cuando la búsqueda no encuentra datos para un conjunto de datos?

Solar Dataset Query V2 documenta una salida null para ese conjunto de datos y una advertencia. Exija que la aplicación la conserve y la comunique.

¿Se expresan los valores horarios de CA como energía?

PVWatts V8 documenta ac horario en Wac. Los valores mensuales ac_monthly y anuales ac_annual están documentados en kWhac.

¿Qué deben comprobar las pruebas de aceptación con entradas no válidas?

Ambos documentos describen HTTP 422 para parámetros no válidos o ausentes. Verifique que la aplicación lee la sección de errores y comunica el fallo.

Puntuación de Calidad:96/100

Acerca del Autor

Cinn Song

Cinn Song

Founder & Chief Solutions Architect

Cinn Song founded SOLARTODO LIMITED and leads its smart-city infrastructure engineering — from solar, storage and integrated smart poles to the company's push into physical-AI city edge nodes: pole-mounted edge computing, vertical LLMs for smart cities, drone-based O&M with autonomous battery swapping, robotic maintenance, and high-speed counter-UAS interception. Since 2010, he has directed turnkey EPC + BOT delivery across 50+ countries, including telecom monopole supply for national grid operators, off-grid solar street-lighting for African municipalities, and integrated smart-pole programs for Gulf smart cities.

Ver Todas las Publicaciones

Citar este artículo

APA

Cinn Song. (2026). Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints. SOLARTODO. Retrieved from https://solartodo.com/es/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations

BibTeX
@article{solartodo_should_the_pv_software_integration_specify_json_or_xml_for_both_climate_data_discovery_and_production_calculations,
  title = {Contratación de API fotovoltaicas: especifique JSON o XML para ambos endpoints},
  author = {Cinn Song},
  journal = {SOLARTODO Knowledge Base},
  year = {2026},
  url = {https://solartodo.com/es/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations},
  note = {Accessed: 2026-11-17}
}

Published: November 17, 2026 | Available at: https://solartodo.com/es/knowledge/should-the-pv-software-integration-specify-json-or-xml-for-both-climate-data-discovery-and-production-calculations

Suscríbase a Nuestro Boletín

Reciba las últimas noticias y perspectivas sobre energía solar directamente en su bandeja de entrada.

Ver Todos los Artículos