Exportacion de Servicios - CUCU API

Para la exportación de servicios a clientes en el exterior. Se emite por POST /api/v1/invoices con documentSectorType: 28.

Datos del sector

Campo	Valor
`documentSectorType`	`28`
Servicio SIAT	Facturación Electrónica / Computarizada (genérico por modalidad)

Campos específicos

Además de los campos estándar:

Cabecera

Campo	Tipo	Req	Descripción
`documentSectorType`	integer	Sí	`28`
`buyerAddress`	string	Sí	Dirección del comprador en el exterior (`dirComprador`)
`destinationPlace`	string	Sí	Lugar de destino del servicio (`lugarDestino`)
`codeCountry`	integer	Sí	Código de país de destino (`codigoPais`, catálogo SIAT)
`currencyCode`	integer	No	Código de moneda de la operación
`exchangeRate`	number	No	Tipo de cambio si la factura es en moneda extranjera

En este sector la cantidad (quantity) de cada ítem debe ser exactamente 1 — lo exige el XSD de exportación de servicios. El sector no usa gift card.

curl -X POST https://sandbox.cucu.bo/api/v1/invoices \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "pointOfSaleId": "660e8400-e29b-41d4-a716-446655440004",
    "documentSectorType": 28,
    "clientDocumentType": 5,
    "clientDocumentNumber": "99001",
    "clientBusinessName": "GLOBAL TECH INC.",
    "buyerAddress": "1200 Market St, San Francisco, CA",
    "destinationPlace": "Estados Unidos",
    "codeCountry": 1,
    "currencyCode": 2,
    "exchangeRate": 6.96,
    "paymentMethodCode": 1,
    "details": [
      {
        "activityEconomic": "620100",
        "codeProductSin": "83141",
        "description": "Desarrollo de software a medida",
        "quantity": 1,
        "unitMeasure": 58,
        "priceUnit": 5000.00
      }
    ]
  }'

const response = await fetch('https://sandbox.cucu.bo/api/v1/invoices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    pointOfSaleId: '660e8400-e29b-41d4-a716-446655440004',
    documentSectorType: 28,
    clientDocumentType: 5,
    clientDocumentNumber: '99001',
    clientBusinessName: 'GLOBAL TECH INC.',
    buyerAddress: '1200 Market St, San Francisco, CA',
    destinationPlace: 'Estados Unidos',
    codeCountry: 1,
    currencyCode: 2,
    exchangeRate: 6.96,
    paymentMethodCode: 1,
    details: [{
      activityEconomic: '620100',
      codeProductSin: '83141',
      description: 'Desarrollo de software a medida',
      quantity: 1,
      unitMeasure: 58,
      priceUnit: 5000.00
    }]
  })
});

import requests

response = requests.post(
    'https://sandbox.cucu.bo/api/v1/invoices',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'YOUR_API_KEY'
    },
    json={
        'pointOfSaleId': '660e8400-e29b-41d4-a716-446655440004',
        'documentSectorType': 28,
        'clientDocumentType': 5,
        'clientDocumentNumber': '99001',
        'clientBusinessName': 'GLOBAL TECH INC.',
        'buyerAddress': '1200 Market St, San Francisco, CA',
        'destinationPlace': 'Estados Unidos',
        'codeCountry': 1,
        'currencyCode': 2,
        'exchangeRate': 6.96,
        'paymentMethodCode': 1,
        'details': [{
            'activityEconomic': '620100',
            'codeProductSin': '83141',
            'description': 'Desarrollo de software a medida',
            'quantity': 1,
            'unitMeasure': 58,
            'priceUnit': 5000.00
        }]
    }
)

Ver Crear Factura para la referencia completa de campos estándar, response y códigos de error.