Validez de comprobantes | Apachiy by Mytems

Endpoint

POST/api/v1/consulta/cpe

URL base: https://apachiy.mytems.cloud

Autenticación

Envía tu token en el encabezado Authorization. El permiso consultas:cpe debe estar habilitado para tu cuenta.

Authorization: Bearer myt_live_TU_TOKEN

Genera el token desde el panel. Guárdalo como secreto y no lo expongas en el navegador, repositorios ni aplicaciones móviles.

Parámetros de la solicitud

Nombre	Tipo	Requerido	Descripción
`numRuc`	string	Sí	RUC del emisor, 11 dígitos.
`codComp`	string	Sí	Tipo: 01 factura, 03 boleta, 04 liquidación de compra, 07 nota de crédito, 08 nota de débito, R1 recibo por honorarios o R7 nota de crédito.
`numeroSerie`	string	Sí	Serie alfanumérica de 1 a 4 caracteres.
`numero`	integer	Sí	Correlativo del comprobante.
`fechaEmision`	string	Sí	Fecha con formato dd/mm/yyyy.
`monto`	number	No	Importe del comprobante, cuando corresponda.

Ejemplo de solicitud

Cambia el token y los datos de ejemplo por los de tu cuenta.

cURL

curl --request POST \
  --url "https://apachiy.mytems.cloud/api/v1/consulta/cpe" \
  --header "Authorization: Bearer myt_live_TU_TOKEN" \
  --header "Accept: application/json"
  --header "Content-Type: application/json" \
  --data '{
    "numRuc": "20123456789",
    "codComp": "01",
    "numeroSerie": "F001",
    "numero": 123,
    "fechaEmision": "15/01/2026",
    "monto": 118
}'

import requests
import json

url = "https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/cpe"
headers = {"Authorization": "Bearer myt_live_TU_TOKEN", "Accept": "application/json"}
payload = json.loads("{\n    \"numRuc\": \"20123456789\",\n    \"codComp\": \"01\",\n    \"numeroSerie\": \"F001\",\n    \"numero\": 123,\n    \"fechaEmision\": \"15/01/2026\",\n    \"monto\": 118\n}")
response = requests.post(url, headers=headers, json=payload, timeout=30)
print(response.status_code, response.json())

const response = await fetch('https://apachiy.mytems.cloud/api/v1/consulta/cpe', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer myt_live_TU_TOKEN',
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "numRuc": "20123456789",
    "codComp": "01",
    "numeroSerie": "F001",
    "numero": 123,
    "fechaEmision": "15/01/2026",
    "monto": 118
}),
});

console.log(response.status, await response.json());

<?php

$url = 'https://apachiy.mytems.cloud/api/v1/consulta/cpe';
$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer myt_live_TU_TOKEN', 'Accept: application/json', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(array (
  'numRuc' => '20123456789',
  'codComp' => '01',
  'numeroSerie' => 'F001',
  'numero' => 123,
  'fechaEmision' => '15/01/2026',
  'monto' => 118.0,
), JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
echo $status . ' ' . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
    "time"
)

func main() {
    req, err := http.NewRequest("POST", "https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/cpe", strings.NewReader(`{
    "numRuc": "20123456789",
    "codComp": "01",
    "numeroSerie": "F001",
    "numero": 123,
    "fechaEmision": "15/01/2026",
    "monto": 118
}`))
    if err != nil { panic(err) }
    req.Header.Set("Authorization", "Bearer myt_live_TU_TOKEN")
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 30 * time.Second}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    responseBody, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    fmt.Println(res.StatusCode, string(responseBody))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class Main {
    public static void main(String[] args) throws Exception {
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https:\/\/apachiy.mytems.cloud\/api\/v1\/consulta\/cpe"))
            .timeout(Duration.ofSeconds(30))
            .header("Authorization", "Bearer myt_live_TU_TOKEN")
            .header("Accept", "application/json")
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("{\n    \"numRuc\": \"20123456789\",\n    \"codComp\": \"01\",\n    \"numeroSerie\": \"F001\",\n    \"numero\": 123,\n    \"fechaEmision\": \"15/01/2026\",\n    \"monto\": 118\n}"))
            .build();
        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://apachiy.mytems.cloud/api/v1/consulta/cpe')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer myt_live_TU_TOKEN'
request['Accept'] = 'application/json'
request['Content-Type'] = 'application/json'
request.body = JSON.generate(JSON.parse(<<~JSON))
{
    "numRuc": "20123456789",
    "codComp": "01",
    "numeroSerie": "F001",
    "numero": 123,
    "fechaEmision": "15/01/2026",
    "monto": 118
}
JSON
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https', read_timeout: 30) { |http| http.request(request) }
puts "#${response.code} #${response.body}"

Respuesta

Estructura real de la respuesta HTTP 200; los valores entre llaves son marcadores de ejemplo.

200 · application/json

{
    "success": true,
    "data": {
        "comprobante": {
            "estado_codigo": "{codigo_estado_cpe}",
            "estado": "{estado_cpe}"
        },
        "contribuyente": {
            "estado_ruc_codigo": "{codigo_estado_ruc}",
            "estado_ruc": "{estado_ruc}",
            "condicion_domicilio_codigo": "{codigo_condicion_domicilio}",
            "condicion_domicilio": "{condicion_domicilio}"
        },
        "observaciones": []
    },
    "request_id": "{uuid_generado_por_la_api}"
}

Los datos devueltos pueden variar según la información disponible. Conserva el request_id para consultar el registro de una solicitud.

Errores y límites

Los errores controlados siguen la estructura { "success": false, "error": { "code": "...", "message": "..." } }. Según el caso, puedes recibir 401 por token inválido, 403 por permiso o servicio inactivo, 422 por datos no válidos y 429 por límite alcanzado.

Las consultas se limitan por el cupo mensual de tu plan y por el límite temporal de solicitudes. Revisa el código de error antes de reintentar.