Para cargar y adjuntar archivos en el momento de la creación del proyecto:
Cargue archivos usando POST/files. Especifique los siguientes datos en la API:
Archivo o dirección URL de archivo
Etiqueta descriptiva para el archivo
Cree el proyecto ecológico y el proyecto de beneficio modular correspondiente y especifique el ID de archivo que se devuelve en la respuesta de la llamada a la API POST/files como un atributo en el cuerpo de solicitud de la API de creación del proyecto: POST/ecoprojects.
Guardar y enviar un proyecto
Recuperar los detalles del proyecto:
GET/ecoProjects/{ecoProjectId}
Vea la lista de archivos (y sus metadatos asociados) adjuntos al proyecto de beneficio modular:
GET/ecoprojects/{ecoProjectId}/mbps/{mbpId}
Descargue un archivo usando el ID de archivo que está disponible como parte de los metadatos del archivo:
GET/files/{fileId}
Agregue los archivos al proyecto de beneficios modular:
POST/files
Especifique el URI del recurso del proyecto de beneficios modulares en el cuerpo de la solicitud.
Envíe el proyecto de beneficio modular para el registro enviando la propuesta MBPRegister:
POST/proposals
Ver un proyecto
Obtener todas las propuestas:
GET/proposals
Recuperar detalles de una propuesta específica:
GET/proposals/{proposalId}
Recuperar detalles un proyecto ecológico específico:
GET/ecoProjects/{ecoProjectId}
Obtener detalles del MBP específico para revisar:
GET/ecoProjects/{ecoProjectId}/mbps/{mbpId}
Obtenga la lista de archivos (y los metadatos asociados) adjuntos al proyecto de beneficio modular:
GET/ecoprojects/{ecoProjectId}/mbps/{mbpId}
Descargue los archivos usando el ID de archivo que está disponible como parte de la respuesta a la API anterior:
GET/files/{fileId}
Adjunte un archivo al proyecto de beneficios modular:
POST/files
Aprobar o rechazar una propuesta
Cargar archivos (si los hay):
POST/archivos y especifique el archivo (o FileUrl) y los detalles de la etiqueta
Rechazar la solicitud de registro:
POST/proposals/{proposalId}/action y especifique los siguientes detalles en el cuerpo de la solicitud
Acción: Rechazar
Mensaje: Especifique un comentario (si lo hay) que desea proporcionar para rechazar el registro.
FileIDs: especifique los ID de archivo de los archivos que se cargaron.
Eliminar un archivo
Vea la lista de archivos adjuntos al proyecto de beneficio modular:
GET/ecoprojects/{ecoProjectId}/mbps/{mbpId}
Identifique el archivo que ha subido, porque un usuario puede eliminar solo los archivos que ha subido.
Eliminar el archivo:
DELETE/files/{fileId}
Devolver una propuesta de ediciones
Si hay lagunas o detalles incorrectos en los atributos o archivos del proyecto que desea que el proveedor corrija o agregue, puede solicitar modificaciones en el proyecto.
Cargar archivos, si los hay, que deben ser compartidos con el proveedor:
POST/files
Mueva la propuesta MBPRegister al estado submitterActionNeeded tomando la acción returnForEdits mediante POST/proposals/{proposalId}/action API y especifique los siguientes detalles en el cuerpo de la solicitud:
Acción: returnForEdits
Mensaje: especifique un comentario (si es necesario) para la referencia del proveedor al enviar la solicitud de edición.
ID de archivo: especifique aquí el ID de archivo del archivo cargado para adjuntar el archivo al proyecto de beneficio modular en cuestión.
Una vez hecho esto, el proyecto de beneficio modular pasa al estado returnedForEdits.
Los proveedores ahora pueden ver la propuesta que se devolvió para su edición. Ahora pueden editar los atributos del proyecto de beneficios modulares y cargar más archivos al proyecto de beneficios modulares.
Ver propuesta: GET/proposals/{proposalId}
Cargue y adjunte archivos al proyecto de beneficio modular: POST/archivos y especifique los siguientes detalles en el cuerpo de la solicitud:
Archivo o dirección URL de archivo
Etiqueta: etiqueta descriptiva para el archivo
ResourceURI: especifique el URI del recurso del proyecto de beneficio modular respectivo.
Actualizar atributos del proyecto de beneficio modular
Obtenga los detalles actualizados del proyecto de beneficios modulares usando GET/ecoprojects/{ecoproject_id}/mbps/{mbp_id} y copie el valor de Etag del encabezado de respuesta.
Actualice los atributos del proyecto de beneficio modular utilizando PATCH/ecoprojects/{ecoproject_id}/mbps/{mbp_id} API y especifique el valor de Etag en la clave If-Match en el encabezado.
Una vez que se completan los cambios, el proveedor ahora puede enviar la propuesta nuevamente al registro utilizando POST/proposals/{proposalId}/action API y especificar los siguientes detalles en la solicitud:
Acción: Enviar
Mensaje: especifique un comentario (si lo hay) para la referencia del registro.
Registrar proyectos de beneficios modulares adicionales
Envíe el beneficio ecológico para el registro al registro emisor creando y enviando una propuesta de MBPRegister:
POST/proposal
Revisar un proyecto de beneficios modulares
Ver los detalles de la propuesta:
GET/proposals/{proposalId}
Ver todos los detalles del proyecto:
GET/ecoProjects/{ecoProjectId}
Vea los detalles del proyecto de beneficio modular individual del proyecto:
GET/ecoprojects/{ecoProjectId}/mbps/{mbpId}
Aprobar o rechazar la propuesta de registro, o devolverla para su edición:
Una vez que se acepta el reclamo, se crea un 'Reclamo procesado' correspondiente. Registre los resultados de su verificación en el reclamo procesado. Esto incluye la actualización de Cantidad, Co beneficios del reclamo. Previo a la presentación de la solicitud de emisión de crédito, deberá actualizar las recomendaciones de crédito también en el reclamo tramitado:
Obtenga los detalles del reclamo procesado usando GET/processedClaims/{processed_claim_id} y copie el valor de Etag del encabezado de respuesta.
Actualice los atributos de la reclamación procesada utilizando la API PATCH/processedClaims/{processed_claim_id} y especifique el valor de Etag en la clave If-Match en el encabezado.
Para cada punto de control que verifique, puede actualizar los resultados de su verificación en el resultado del punto de control correspondiente del reclamo procesado:
Cargue y adjunte sus informes de búsqueda de verificación a los resultados del punto de control de la reclamación procesada mediante POST/API de archivos y especifique el archivo o la URL del archivo, la etiqueta y el ResourceUri (este será el URI del recurso del resultado del punto de control) en el cuerpo de la solicitud.
Actualice el efecto ambiental antes y después de los atributos del resultado del punto de control (si es necesario):
Obtenga los detalles del resultado del punto de comprobación usando GET/processedClaims/{processed_claim_Id}/checkpointResults/{checkpoint_result_Id} y copie el valor de Etag del encabezado de respuesta.
Actualice los atributos del resultado del punto de comprobación utilizando la API PATCH/processedClaims/{processed_claim_Id}/checkpointResults/{checkpoint_result_Id} y especifique el valor de Etag en la clave If-Match en el encabezado.
También puede actualizar los resultados del punto de control utilizando la API de parches para reclamos procesados.
Una vez completada la verificación, apruebe o rechace la propuesta MBPClaimVerify:
POST/proposals/{proposalId}/action
Especifique los siguientes datos:
Acción: Aprobar o rechazar
Mensaje: especifique un comentario (si lo hay) para la referencia del proveedor.
Una vez aprobada la propuesta MBPClaimVerify, cree y envíe la propuesta CreditMint para enviar la solicitud de emisión de crédito:
POST/proposals/
Devolución de solicitud de reclamación por modificaciones
Si hay lagunas o detalles incorrectos en la solicitud de reclamación que el organismo de validación y verificación desea que el proveedor corrija, puede solicitar modificaciones en ella en lugar de aprobar o rechazar la solicitud. Esta capacidad está disponible solo a través de la API.
Cargue y adjunte archivos (que desee compartir con el proveedor) al reclamo procesado o al resultado del punto de control del reclamo procesado: POST/archivos y especifique los siguientes detalles en el cuerpo de la solicitud
Archivo o dirección URL de archivo
Etiqueta
URI de recurso del reclamo procesado o resultado del punto de control del reclamo procesado al que se debe agregar el archivo
Mueva la propuesta MBPClaimVerify al estado submitterActionNeeded tomando la acción returnForEdits mediante POST/proposals/{proposalId}/action API y especifique los siguientes detalles en el cuerpo de la solicitud:
Acción: returnForEdits
Mensaje: especifique un comentario (si es necesario) para la referencia del proveedor al enviar la solicitud de edición.
Edite la propuesta devuelta
Los proveedores aluego pueden ver la propuesta que se devolvió para su edición. Ahora pueden editar los atributos de reclamo y punto de control, y pueden cargar más archivos en los puntos de control de reclamo:
Ver propuesta: GET/proposals/{proposalId}
Si es necesario, el proveedor también puede ver los detalles de la reclamación procesada correspondiente mediante la API GET/processedClaims/{processed_claim_Id}.
Cargue y adjunte archivos (si los hay) a los puntos de comprobación de la reclamación: POST/archivos y especifique los siguientes detalles en el cuerpo de la solicitud
Archivo o dirección URL de archivo
Etiqueta
URI de recurso del punto de control al que se debe agregar el archivo
Actualice los atributos de la notificación mediante una operación PATCH:
Obtenga los últimos detalles del reclamo y anote el valor de ETag en el encabezado de respuesta: GET/ecoprojects/{ecoproject_id}/mbps/{mbp_id}/mbpclaims/{mbpclaim_id}
Actualice los atributos de la reclamación y especifique el valor de Etag en la clave 'If-Match' en el encabezado de la solicitud: PATCH /ecoprojects/{ecoproject_id}/mbps/{mbp_id}/mbpclaims/{mbpclaim_id}
Actualice los atributos del punto de comprobación de la reclamación mediante una operación PATCH:
Obtenga los últimos detalles del punto de comprobación y anote el valor de ETag en el encabezado de respuesta: GET /ecoprojects/{ecoproject_id}/mbps/{mbp_id}/mbpclaims/{mbpclaim_id}/checkpoints/{mbpcheckpoint_id}
Actualice los atributos de la reclamación y especifique el valor de Etag en la clave If-Match en el encabezado de la solicitud: PATCH /ecoprojects/{ecoproject_id}/mbps/{mbp_id}/mbpclaims/{mbpclaim_id}/checkpoints/{mbpcheckpoint_id}
Nota
Al especificar los atributos de actualización, asegúrese de que el cuerpo de la solicitud JSON siga la misma estructura que en la llamada de API de obtención correspondiente.
Una vez que se completan los cambios, el proveedor luego puede enviar la propuesta nuevamente al cuerpo de validación y verificación utilizando POST/proposals/{proposalId}/action API y especificar los siguientes detalles en el cuerpo de la solicitud:
Acción: Reenviar
Mensaje: Especifique cualquier comentario (si es necesario) para la referencia del cuerpo de validación y verificación.
Después de volver a enviar la propuesta, el organismo de validación y verificación puede revisarla y aprobarla, rechazarla o volver a solicitar modificaciones.
Retirar la solicitud de emisión de crédito
Opción para retirar la propuesta de solicitud de emisión de crédito (CreditMint) enviada:
Después de enviar la propuesta de emisión de crédito al registro, en caso de cualquier problema por el cual desee retirar la propuesta presentada, puede retirar la propuesta presentada si el registro no ha actuado sobre la propuesta. Actualmente esta capacidad solo está disponible mediante API.
Mueva la propuesta de CreditMint que está en estado enviado a estado retirado mediante la API POST/proposals/{proposalId}/action y especifique los siguientes detalles en el cuerpo de la solicitud :
Acción: Retirar
Mensaje: Especifique el motivo (si lo hubiere) para retirar la propuesta de referencia de registro.
El estado de la propuesta es ahora Retirada.
Después de que se retira la solicitud de emisión de crédito, el organismo de validación y verificación puede modificar el 'reclamo procesado' y los resultados del punto de control asociado y luego volver a enviar la solicitud de emisión de crédito.
Cargue y adjunte archivos a los resultados del punto de comprobación de la reclamación procesada: POST/archivos y especifique los siguientes detalles:
Archivo o FileURL
Etiqueta
ResourceURI del resultado del punto de control asociado.
Actualice los atributos del reclamo procesado: PATCH/processedClaims/{processedClaim_Id}
Vuelva a enviar la solicitud de emisión al registro y especifique los siguientes detalles en el cuerpo de la solicitud de la API: POST/proposals/{ proposal_id}/action
Acción: Especificar como Reenviar
Mensaje: especifique un mensaje o comentario (si lo hay) para la referencia del registro
Vea la propuesta de 'Token mint' enviada y obtenga el URI de recurso de 'reclamación procesada' que se envió para su revisión:
GET/proposal/{proposalId}
Revise los hallazgos de verificación del organismo de validación y verificación al ver el reclamo procesado y los resultados del punto de control asociado (junto con los archivos asociados):
GET/processedClaims/{processedClaims_Id}
Vea el reclamo y los detalles correspondientes del punto de control (junto con la lista de archivos adjuntos por el proveedor para los puntos de control):
Vea los detalles del proyecto de beneficio modular, junto con la lista de archivos adjuntos:
GET/ecoprojects/{ecoProjectId}/mbps/{mbpId}
Descargue un archivo con el ID de archivo:
GET/files/{fileId}
Aprobar créditos
Cargue los archivos que desea adjuntar al crédito para la emisión: POST/archivos y especifique los siguientes detalles en el cuerpo de la solicitud:
Archivo o dirección URL de archivo
Etiqueta
Aprobar la propuesta:
POST/proposals/{proposalId}/action
En el cuerpo de la solicitud, especifique los siguientes detalles:
Acción: especificar como Mint
Mensaje: Especificar el mensaje (si lohay) para la referencia del cuerpo de validación y verificación
ID de archivo: especifique las ID de archivo de los archivos cargados para que los archivos se adjunten al crédito emitido
Cantidad
Antiguo
Id. de activo
Valor detrminado
Nota
Cuando la propuesta sea aprobada, se creará el crédito correspondiente.
Rechazar una propuesta
Cargue y adjunte archivos (si los hay) a la reclamación procesada: POST/archivos y especifique los siguientes detalles:
Archivo o dirección URL de archivo
Etiqueta
Rechazar la propuesta:
POST/proposals/{proposalId}/action
En el cuerpo de la solicitud, especifique los siguientes detalles:
Acción: Rechazar
Mensaje: Especificar un mensaje (si lohay) para la referencia del cuerpo de validación y verificación
ID de archivo: especifique aquí los id. de archivo del archivo cargado de modo que estén adjuntos a la reclamación procesada asociada.
Devolver solicitud de emisión de crédito para ediciones
Si hay lagunas o detalles incorrectos en la solicitud de seguros que desea que el organismo de validación y verificación corrija, puede solicitar modificaciones la solicitud de emisión. Esta capacidad está disponible solo a través de la API.
Cargue los archivos (si los hay) que desee compartir con el organismo de validación y verificación como parte del envío de la solicitud de emisión para su edición.
Mueva la solicitud de emisión (propuesta CreditMint) al estado submitterActionNeeded mediante la API POST/proposals/{proposalId}/action y especifique los siguientes detalles:
Acción: ReturnForEdits
Mensaje: especifique un mensaje (si lo hay) para la referencia del cuerpo de validación y verificación para que puedan comprender el motivo de la solicitud de edición.
ID de archivo: especifique aquí los id. de los archivos cargados (si los hay) de modo que estén adjuntos a la reclamación procesada asociada.
El organismo de validación y verificación ahora puede ver la propuesta que se ha devuelto para su edición. Ahora también pueden editar el reclamo procesado correspondiente y los resultados del punto de control. Pueden actualizar atributos y cargar archivos actualizados en los resultados del punto de control.
Si es necesario, el organismo de validación y verificación en este punto puede solicitar aclaraciones sobre el reclamo verificado devolviendo el reclamo al proveedor para que lo edite. Una vez que el proveedor vuelve a presentar el reclamo, el organismo de validación y verificación puede revisar y verificar el reclamo, actualizar el reclamo procesado correspondiente y luego volver a presentar la solicitud de emisión al registro.
Cargue y adjunte archivos a los resultados del punto de comprobación: POST/archivos y especifique los siguientes detalles:
Archivo o dirección URL de archivo
Etiqueta
ResourceURI de los resultados del punto de control asociado
Actualice los atributos del reclamo procesado, incluida la recomendación de crédito: PATCH/processedClaim/{id de reclamo procesado}
Vuelva a enviar la solicitud de emisión y especifique los siguientes detalles en el cuerpo de la solicitud de la API: POST/proposals/{ proposal_id}/action
Acción: Reenviar
Mensaje: especifique un mensaje (si lo hay) para la referencia del registro
Después de volver a enviar la solicitud, el registro emisor puede revisarla y aprobarla, rechazarla o volver a solicitar modificaciones.
Ver créditos emitidos
GET/credits
Buscar y ver créditos
Obtener todos los créditos:
GET/credits
Nota
Esta API devolverá la lista de todos los créditos. Luego, los compradores pueden filtrar la lista por su cuenta según el estado del crédito para ver solo los créditos enumerados.
Vea los detalles del crédito (incluido el linaje) de un crédito específico que se muestra en la lista:
Fraccionar un crédito es una operación independiente en el Servicio de crédito medioambiental. Para obtener información sobre cómo dividir un crédito a través de la API, vaya a Dividir un crédito. Después de que se divide el crédito, puede continuar con el siguiente paso.
Cree y envíe una propuesta de MarketplaceListingDeregister:
POST/proposals
Vea todas las propuestas de MarketplaceListingDeregister enviadas para su revisión:
GET/proposals
Para aprobar o rechazar la propuesta:
POST/proposals/{proposalId}/action
Transferir la propiedad
POST/credits/{creditId}/transfer/
Ver linaje de crédito
Las organizaciones con roles de proveedor y registro pueden ver el linaje de crédito de los créditos que poseen o han emitido:
GET/credits/{creditId}/lineage
Dividir un crédito
Puede dividir un crédito en créditos para niños. Actualmente, esta funcionalidad solo está disponible con la API.
Dividir el crédito especificando las cantidades (en mtCO2e) para al menos dos créditos para niños como propietario de crédito (para los créditos que poseen) o como mercado (para los créditos enumerados en su plataforma):
POST/credits/{creditId}/split
Transferir lista de crédito
Un mercado puede transferir una lista de crédito de su plataforma a otro mercado. Esta transferencia también se conoce como transferencia de gravamen. En el flujo tradicional, un proveedor enumeraría los créditos en un mercado que ayudará con la demanda, la compensación y la liquidación. A veces, es posible que un mercado no pueda realizar la compensación y liquidación de pagos por sí solo y puede depender de una plataforma diferente para realizarlo. En este caso, el activo debe transferirse al nuevo mercado para completar la transacción. Actualmente, esta característica solo está disponible con las API.
Como mercado, cree y envíe la propuesta MarketplaceListingTransfer para un crédito que figura en su plataforma:
POST/proposals
Como mercado aprobador, vea todas las propuestas de MarketplaceListingTransfer que se les enviaron para su revisión:
GET/proposals
Como mercado aprobador, apruebe o rechace la propuesta. Si se aprueba la propuesta, el gravamen de créditos se transfiere del mercado inicial al mercado aprobador:
POST/proposals/{proposalId}/action
Transferencia parcial de gravamen: un mercado puede transferir gravamen por crédito parcial dividiendo primero el crédito como una acción independiente. Para obtener información sobre cómo dividir un crédito, vaya a Dividir un crédito. Después de dividir el crédito, continúe con los pasos anteriores para la transferencia de gravamen para créditos por hijos.
Establecer objetivos de emisión
Esta sección le muestra cómo configurar metas y objetivos de reducción de emisiones a través de las API.
Esta sección le muestra cómo realizar un seguimiento de sus emisiones en comparación con el cuadro de mando de emisiones que estableció a través de las API. Para obtener instrucciones sobre el uso de la interfaz de usuario, vaya a Seguir los objetivos de emisión en el Servicio de crédito medioambiental.
Esta sección le muestra cómo compensar el exceso de emisiones retirando los créditos de carbono propios a través de las API. Para obtener instrucciones sobre el uso de la interfaz de usuario, vaya a Retirar créditos en el Servicio de crédito medioambiental.
Los compradores también pueden retirar los créditos de carbono directamente sin especificar las emisiones a compensar. Esta funcionalidad solo está disponible mediante las API.
Cree y envíe la propuesta de CreditRetire:
POST/proposals
Revisar propuesta de retirada de crédito
GET/proposals
GET/proposals/{proposalId}
Adjuntar archivo al crédito que se está revisando para retiro:
POST/files
POST/proposals/{proposalId}/action
Retirada de crédito parcial
Para obtener información sobre cómo dividir un crédito a través de la API, vaya a Dividir un crédito.
Después de dividir el crédito, utilice las API de los pasos anteriores para la compensación y el retiro.
Administrar archivos
Esta sección le muestra cómo adjuntar, ver y eliminar archivos para activos como proyectos, reclamos y créditos a través de las API. Para obtener instrucciones sobre el uso de la interfaz de usuario, vaya a Gestionar archivos en el Servicio de crédito medioambiental.
Demuestre los aspectos básicos de la seguridad de los datos, la administración del ciclo de vida, la seguridad de la información y el cumplimiento para proteger una implementación de Microsoft 365.