Declarar

Este método envía el XML a SUNAT mediante web services.

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}}/factura/declarar

Headers

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

Estructura Body

El objeto documento representa el documento a validar.

• configuracion: Contiene los parámetros de configuración de la petición.

{
  "documento": {
    ...,
    "configuracion": {...}  
  }
}

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

Implementación

Shell

  curl "{{URL_API}}/factura/declarar" -X POST \
    -H "emite_id: {{EMITE_ID}}" \
    -H "emite_key: {{EMITE_KEY}}" \
    -H "Content-Type: application/json" \
    -d "{\"documento\":{...,\"configuracion\":{...}}}"

Node

  const axios = require('axios');

  const data = {
    documento: {
      // ...,
      configuracion: {
        // ...
      }
    }
  };

  axios.post('{{URL_API}}/factura/declarar', 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}}/factura/declarar");
          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 = """
          {
            "documento": {
              "configuracion": {
              }
            }
          }
          """;

          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)[
      'documento' => (object)[
          // ...,
          'configuracion' => (object)[
              // ...
          ]
      ]
  ];

  $ch = curl_init('{{URL_API}}/factura/declarar');

  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
documento	Requerido	object	Contiene los datos del documento.
documento. serie	Requerido	string	Contiene la serie del documento.
documento. correlativo	Requerido	integer Tamaño: [1...8]	Contiene el correlativo del documento.
documento. configuracion	Opcional	object	Contiene los parámetros de configuración de la petición.
documento. configuracion. notificar	Opcional	boolean	Indica si se quiere notificar mediante email.
documento. configuracion. noRetornarCdr	Opcional	boolean	Indica si se quiere obviar en la respuesta el XML del CDR.

Response

Si el código de estado es 200 la petición anterior retorna un JSON estructurado de la siguiente manera:

Success

200 — Cuando el proceso se ejecute correctamente.

{
  "ticketPeticion": "1537486212351-1024216",
  "estado": 3,
  "nombreEstado": "ACEPTADO",
  "estadoSunat": "0",
  "observaciones": [
    "La factura F001-1 fue aceptada"
  ],
  "cdr": {
    "name": "CDR_20600323751-01-F001-1.xml",
    "content": "contenido-del-archivo",
    "contentType": "text/xml"
  }
}

Propiedad	Condición	Tipo	Descripción
ticketPeticion	Siempre	string	Código identificador de la petición.
estado	Siempre	integer	Código interno de estado del documento.
nombreEstado	Siempre	string	Descripción de estado interno del documento.
estadoSunat	Siempre	string	Código de validación SUNAT.
observaciones	Siempre	array[string]	Lista de mensajes asociados a la operación.
cdr	Cuando documento. configuracion. noRetornarCdr es null o false	object	Contiene los datos del archivo CDR.
cdr. name	Cuando documento. configuracion. noRetornarCdr es null o false	string	Nombre del archivo.
cdr. content	Cuando documento. configuracion. noRetornarCdr es null o false	string Base64	Contenido del byte[] representado en Base64.
cdr. contentType	Cuando documento. configuracion. noRetornarCdr es null o false	string text/xml	Nombre del mime type del archivo.

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": "NOT_FOUND",
  "mensaje": "El documento F001-1 no ha sido registrado"
}

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.