Notificar

Este método envía por email, de forma asíncrona, los archivos de uno o varios documentos.

Valores

Variable	Descripción	Prod	Demo
URL_API	URL base de la API	https://api.emite.pe	https://api.demo.emite.pe
EMITE_ID	Identificador asignado a la empresa	Proporcionado por Emite	Proporcionado por Emite
EMITE_KEY	API Key asignada a la empresa	Proporcionado por Emite	Proporcionado por Emite

Request

POST {{URL_API}}/nota-debito/notificar

Headers

emite_id: {{EMITE_ID}}
emite_key: {{EMITE_KEY}}
Content-Type: application/json

Estructura Body

El arreglo documentos contiene los documentos que serán notificados por correo.

• email: objeto de cada documento que contiene la información de los destinatarios del correo.

{
  "documentos": [
    {
      ...,
      "email": {...}  
    }
  ]
}

La estructura completa del body se detalla en la tabla Propiedades Body.

Implementación

Shell

  curl "{{URL_API}}/nota-debito/notificar" -X POST \
    -H "emite_id: {{EMITE_ID}}" \
    -H "emite_key: {{EMITE_KEY}}" \
    -H "Content-Type: application/json" \
    -d "{\"documentos\":[{...,\"email\":{...}}]}"

Node

  const axios = require('axios');

  const data = {
    documentos: [
      {
        // ...,
        email: {
          // ...
        }
      }
    ]
  };

  axios.post('{{URL_API}}/nota-debito/notificar', data, {
    headers: {
      emite_id: '{{EMITE_ID}}',
      emite_key: '{{EMITE_KEY}}',
      'Content-Type': 'application/json'
    }
  })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response?.data || error.message);
  });

Java

  import java.io.OutputStream;
  import java.net.HttpURLConnection;
  import java.net.URL;

  public class Main {
      public static void main(String[] args) throws Exception {

          URL url = new URL("{{URL_API}}/nota-debito/notificar");
          HttpURLConnection conn = (HttpURLConnection) url.openConnection();

          conn.setRequestMethod("POST");
          conn.setRequestProperty("emite_id", "{{EMITE_ID}}");
          conn.setRequestProperty("emite_key", "{{EMITE_KEY}}");
          conn.setRequestProperty("Content-Type", "application/json");
          conn.setDoOutput(true);

          String json = """
          {
            "documentos": [
              {
                "email": {
                }
              }
            ]
          }
          """;

          try (OutputStream os = conn.getOutputStream()) {
              byte[] input = json.getBytes("utf-8");
              os.write(input, 0, input.length);
          }

          int statusCode = conn.getResponseCode();
          System.out.println("HTTP Status: " + statusCode);
      }
  }

PHP

  <?php

  $data = (object)[
      'documentos' => [
          (object)[
              // ...,
              'email' => (object)[
                  // ...
              ]
          ]
      ]
  ];

  $ch = curl_init('{{URL_API}}/nota-debito/notificar');

  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'emite_id: {{EMITE_ID}}',
      'emite_key: {{EMITE_KEY}}',
      'Content-Type: application/json'
  ]);

  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

  $response = curl_exec($ch);

  if (curl_errno($ch)) {
      echo 'Error: ' . curl_error($ch);
  } else {
      echo $response;
  }

  curl_close($ch);

Propiedades Body

Propiedad	Obligatoriedad	Tipo	Descripción
documentos	Requerido	array[object]	Contiene el listado de documentos a notificar.
documentos[i]. serie	Requerido	string Tamaño: [4]	Contiene la serie del documento.
documentos[i]. correlativo	Requerido	integer Tamaño: [1...8]	Contiene el correlativo del documento.
documentos[i]. email	Requerido	object	Contiene la información de los destinatarios del correo.
documentos[i]. email. to	Requerido	array[string] Debe enviarse al menos un destinatario	Lista de emails a los que se notificará el documento en "PARA".
documentos[i]. email. cc	Requerido	array[string] Debe enviarse un arreglo vacío [] cuando no existan destinatarios	Lista de emails a los que se notificará el documento en "CON COPIA".
documentos[i]. email. bcc	Requerido	array[string] Debe enviarse un arreglo vacío [] cuando no existan destinatarios	Lista de emails a los que se notificará el documento en "CON COPIA OCULTA".

Response

Si el código de estado es 204 la notificación fue procesada correctamente.

Success

204 — Cuando el proceso se ejecute correctamente.

Si el código de estado es 400, 401, 402, 403, 404 o 500 la petición anterior retorna un JSON estructurado de la siguiente manera:

Bad Request

400 - ERROR DE ESTRUCTURA JSON O EN LOS PARÁMETROS ENVIADOS.

Unauthorized

401 - ERROR DE AUTORIZACIÓN.

Payment Required

402 - ERROR POR FALTA DE PAGO.

Forbidden

403 - ERROR POR VALIDACIONES.

Not Found

404 - RECURSO NO ENCONTRADO.

Internal Server Error

500 - ERROR EN EL SERVIDOR.

{
  "ticketPeticion": "1537486212351-1024216",
  "estado": "FORBIDDEN",
  "mensaje": "El número del comprobante no es correcto"
}

Propiedad	Condición	Tipo	Descripción
ticketPeticion	Siempre	string	Código identificador de la petición.
estado	Siempre	string	Nombre del estado HTTP retornado: BAD_REQUEST UNAUTHORIZED PAYMENT_REQUIRED FORBIDDEN NOT_FOUND INTERNAL_SERVER_ERROR.
mensaje	Siempre	string	Descripción del resultado o error retornado por la API.