API Facturación AFIP V2

Comprobantes de exportación de tipo "E"

API de facturación electrónica AFIP para emitir comprobantes de exportación de tipo E: FACTURA E, NOTA DE DÉBITO E, NOTA DE CRÉDITO E.

TusFacturasAPP es un proveedor SaaS líder de servicios de facturación electrónica en Argentina, que permite a empresas de todos los tamaños emitir comprobantes fiscales válidos de manera rápida, segura y cumpliendo con todas las regulaciones de la AFIP.

¿Qué podes hacer con la API para facturación AFIP?

Integra fácilmente la facturación electrónica en tu software con la API de TusFacturasAPP. Emite comprobantes fiscales válidos desde tu sistema y obtén respuestas inmediatas de la AFIP.

¿Cómo empiezo?

Te sugerimos revisar la guia de ¿Cómo empiezo? . Una vez configurada tu cuenta y creado tu CUIT+Punto de venta (PDV) en TusFacturasAPP, podrás comenzar a emitir facturas electrónicas AFIP Argentina válidas.

Comenza ya a cumplir con las regulaciones fiscales y brinda una experiencia de facturación digital eficiente a tus clientes. Solicita acceso a nuestra API de facturación electrónica.A continuación te mostramos la estructura de los datos que se requieren para generar un comprobante de tipo exportación, ya sea NC, ND o FACTURA.

¿Qué son las Facturas Electrónicas de Exportación "E"?

Las Facturas Electrónicas de Exportación "E" son comprobantes digitales que respaldan las ventas de bienes o servicios realizados a clientes en el exterior. Son emitidas de forma obligatoria por empresas argentinas que realizan operaciones de exportación.

¿Qué las diferencia de las facturas electrónicas comunes?

  • Uso específico: Las Facturas "E" se utilizan exclusivamente para ventas a compradores no residentes en el país.

  • Información adicional: Las Facturas "E" requieren datos específicos relacionados con la exportación, como el destino de la mercadería, el medio de transporte y los datos del comprador extranjero.

  • Exención de IVA: Las exportaciones de bienes y servicios generalmente están exentas del IVA, lo que se refleja en las Facturas "E".

¿Quiénes deben emitir Facturas "E"?

Están obligadas a emitir Facturas "E" todas las empresas argentinas que realicen:

  • Ventas de bienes al exterior: Incluye productos físicos, como mercaderías, maquinaria y alimentos.

  • Prestaciones de servicios a no residentes: Abarca servicios como consultoría, turismo, transporte internacional y otros.

¿Cómo emitir Facturas "E"?

La emisión de Facturas "E" se realiza de forma electrónica a través de AFIP o mediante software homologado por la AFIP, como lo es TusFacturas.app.

¿Cómo crear una Comprobantes de exportacion "E"?

En esta guía encontrarás:

  • Explicación detallada del servicio en nuestra guia: API Facturación AFIP.

  • Requerimientos específicos para cada tipo de solicitud.

  • Datos exactos para generar nuevos comprobantes de venta.

  • Documentación completa y ejemplos de código para una integración rápida y eficiente.

Emisión simplificada de Comprobantes "E":

Para emitir Comprobantes Electrónicos de Exportación ("E"), solo debes agregar el bloque "fex" al request que construyas, con la siguiente estructura :

Ejemplo de JSON para FACTURA E

{ 

  "comprobante": { 
        ..., 
        "fex": {
              "permisos_tiene"      : "S" ,
              "fecha_pago"          : "12/10/2019",
              "tipo_exportacion"    : "2",
              "pais_comprobante_id" : "123",
              "forma_pago_leyenda"  : "Payment via paypal 30 days ",
              "cliente_pais_cuit"   : "50000000016",
              "incoterms_tipo_id"   : "FOB",
              "incoterms_nro"       : "AAAAGGGGGGGGGGGAAA ",
              "permisos"    : [
                                  {
                                      "codigo_despacho"  :  "1234567890123456",
                                       "pais_destino_id" :    "112"
                                  },

                                  {
                                      "codigo_despacho"   :  "1234567890144456",
                                       "pais_destino_id"  :    "123"
                                  },
                                   {
                                      "codigo_despacho"   :    "4444567890123456",
                                       "pais_destino_id"  :    "145"
                                  }
                              ]
               
      }
}

¿Cómo enviar una factura E según mi lenguaje de programación?

Podes enviar las facturas E por CURL, o usando tu lenguaje de programación favorito. A continuación te mostramos algunos ejemplos.

curl --request POST \
  --url https://www.tusfacturas.app/app/api/v2/facturacion/nuevo \
  --header 'Content-Type: application/json' \
  --data '{
   "usertoken":"xxxxx",
   "apikey":"xxxx",
   "apitoken":"xxxxx",
   "cliente":{
      "documento_tipo":"CUIT",
      "documento_nro":"30712293841",
      "razon_social":"VOUSYS TusFacturasAPP",
      "email":"a@a.com",
      "domicilio":"AV.LIBERTADOR 571",
      "provincia":"2",
      "envia_por_mail":"S",
      "condicion_pago":"211",
      "condicion_iva":"RI",
      "rg5329":"N"
   },
   "comprobante":{
      "fecha":"20/03/2018",
      "vencimiento":"26/03/2023",
      "tipo":"FACTURA E",
      "operacion":"V",
      "punto_venta":"0002",
      "numero":"00000012",
      "periodo_facturado_desde":"28/02/2018",
      "periodo_facturado_hasta":"28/02/2018",
      "rubro":"Alimentos",
      "rubro_grupo_contable":"Alimentos",
      "detalle":[
         {
            "cantidad":"1",
            "producto":{
               "descripcion":"EXENTO - AVENA INSTANTANEA x5 kg. al 21",
               "unidad_bulto":"1",
               "lista_precios":"Lista de precios API 3",
               "codigo":"16098",
               "precio_unitario_sin_iva":"100",
               "alicuota":"-1",
               "rg5329":"N"
            },
            "leyenda":""
         },
         {
            "cantidad":"1",
            "producto":{
               "descripcion":"p2",
               "unidad_bulto":"1",
               "lista_precios":"Lista de precios API 3",
               "codigo":"160398",
               "precio_unitario_sin_iva":"10",
               "alicuota":"21",
               "rg5329":"N"
            },
            "leyenda":""
         }
      ],
      "bonificacion":"0.00",
      "leyenda_gral":" ",
      "tributos":[
         {
            "tipo":6,
            "regimen":2,
            "base_imponible":100,
            "alicuota":10,
            "total":10
         },
         {
            "tipo":7,
            "regimen":5,
            "base_imponible":200,
            "alicuota":10,
            "total":20
         }
      ],
      "impuestos_internos":"0",
      "impuestos_internos_base":"0",
      "impuestos_internos_alicuota":"0",
      "total":"142.1",
		 "fex": {
              "permisos_tiene"      : "S" ,
              "fecha_pago"          : "12/10/2019",
              "tipo_exportacion"    : "2",
              "pais_comprobante_id" : "123",
              "forma_pago_leyenda"  : "Payment via paypal 30 days ",
              "cliente_pais_cuit"   : "50000000016",
              "incoterms_tipo_id"   : "FOB",
              "incoterms_nro"       : "AAAAGGGGGGGGGGGAAA ",
              "permisos"    : [
                                  {
                                      "codigo_despacho"  :  "1234567890123456",
                                       "pais_destino_id" :    "112"
                                  },

                                  {
                                      "codigo_despacho"   :  "1234567890144456",
                                       "pais_destino_id"  :    "123"
                                  },
                                   {
                                      "codigo_despacho"   :    "4444567890123456",
                                       "pais_destino_id"  :    "145"
                                  }
                              ]
               
      }
		 
   }
}'

Información de cada uno de los campos :

tipo_exportacion

Campo numérico. Longitud 1 caracter. Valores esperados: 1= Exportación definitiva de bienes 2= Servicios 4= Otros. Ejemplo: 2

permisos_tiene

Campo alfabético. Longitud 1 caracter. Indica si se posee documento aduanero de exportación (permiso de embarque). Valores esperados: S= Si posee N= No posee (vacio)= No especifica Ejemplo: S

permisos

Solo deberán ser enviados los permisos cuando el campo permisos_tiene sea igual a "S". Valores a enviar según estructura de datos definida a continuación en "Permisos de exportacion".

pais_comprobante_id

Campo numérico. Según tabla de referencia Paises AFIP (**) Ejemplo: 123

forma_pago_leyenda

Campo alfanumérico. Descripción adicional de la forma de pago Ejemplo: Favor depositar en cuenta XXXXX

cliente_pais_cuit

Campo numérico. Según tabla de referencia CUIT Pais AFIP (**) Ejemplo: 51600004380

incoterms_tipo_id

Campo alfabético Incoterms – Cláusula de Venta. Según tabla de referencia Incoterms (**) Ejemplo: EXW

incoterms_nro

Campo alfanumérico - Información complementaria del incoterm Ejemplo: Texto dic.

comprobantes_asociados

OPCIONAL. Se deberá informar el/los comprobante/s asociados solamente si el comprobante que se está autorizando corresponde a una Nota de Débito o Nota de Crédito. Según estructura de "Comprobantes asociados".

fecha_pago

Campo fecha - formato esperado: dd/mm/aaaa. Éste campo es obligatorio únicamente para Facturas E, si se envia tipo_exportacion = 2 o tipo_exportacion=4

Estructura de "Permisos "

El bloque de "permisos" es un array con cada uno de los permisos de exportación que dispongas. Cada uno de éstos debe ser enviado acordes a la estructura que se detalla a continuación

{
 "codigo_despacho"  :  "1234567890123456",
 "pais_destino_id" :    "112"
}

Información de los campos a enviar:Información de los campos a enviar:

codigo_despacho

Campo alfanumérico. Longitud 16 caracteres. Deberá ser un permiso válido, formato 99999AAXX999999A (donde XX podrán ser números o letras).

pais_destino_id

Campo numérico. Según tabla de referencia Paises AFIP (**) Ejemplo: 123

Datos a tener en cuenta para los comprobantes de exportación:

Los siguientes campos dentro del json del comprobante deberá enviarlos en cero:

  • bonificación,

  • no gravados

  • impuestos internos.

El bloque tributos deberá ser enviado vacío.

Notas de crédito E / Notas de débito E

En caso que debas anular una factura de exportación, el comprobante que debes emitir es una Nota de crédito E, para ésto debes agregar dentro del bloque "fex" un bloque adicional según estructura de "comprobantes_asociados", que es un array con cada uno de los comprobantes de tipo E que se quieren anular contablemente. Te sugerimos consultar la documentación de Notas de crédito / Notas de débito para conocer como el bloque que debes enviar.

Solo deberán ser enviados los comprobantes asociados, cuando el campo exportacion_tipo sea igual a "1" .

Ejemplo de NOTA DE DÉBITO E

{
"usertoken" :  "jajajja8c8bf67c884e1405e26c03c85",
"apikey"    :  "9991",
"apitoken"  :  "kkakak208a17cdfc4e4741437baddaa6",
"cliente"   :
                {   
                .....
                },
"comprobante":  {
                ....,
                "fex": {
                            "permisos_tiene"      : "S" ,
                            "tipo_exportacion"    : "1",
                            "pais_comprobante_id" : "123",
                            "forma_pago_leyenda"  : "Payment via paypal 30 days ",
                            "cliente_pais_cuit"   : "50000000016",
                            "incoterms_tipo_id"   : "FOB",
                            "incoterms_nro"       : "AAAAGGGGGGGGGGGAAA ",
                            "permisos"    : [
                                                {
                                                    "codigo_despacho"  :  "1234567890123456",
                                                     "pais_destino_id" :    "112"
                                                },
                    
                                                {
                                                    "codigo_despacho"   :  "1234567890144456",
                                                     "pais_destino_id"  :    "123"
                                                },
                    
                                                 {
                                                    "codigo_despacho"   :    "4444567890123456",
                                                     "pais_destino_id"  :    "145"
                                                }
                                            ],
                           "comprobantes_asociados": [
                                                {
                                                    "tipo_comprobante"   :    "NOTA DE CREDITO E",
                                                     "punto_venta"  :    "145",
                                                     "numero" : 12313,
                                                     "cuit": 30111222334     
                                                } 
                                           ]
                    },
                "detalle": [
                          .... ]
        }
}

Ejemplo de llamada en PHP

// ENVIO REQUEST
$url ="https://www.tusfacturas.app/app/api/v2/facturacion/nuevo" ;
$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_POSTFIELDS,  json_encode($data) );
curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$json_rta_curl =  json_decode(  curl_exec($ch) ) ;  
curl_close($ch);

// MUESTRO RESPUESTA
echo "<p>MENSAJE:". $json_rta_curl->rta."</p>"; 
echo "<p>Vencimiento del pago:".$json_rta_curl->vencimiento_pago."</p>"; 
echo "<p>CAE:".$json_rta_curl->cae."</p>"; 
echo "<p>Vencimiento del cae:".$json_rta_curl->vencimiento_cae."</p>"; 
echo "<p>Comprobante pdf url:".$json_rta_curl->comprobante_pdf_url."</p>"; 
echo "<p>error:". $json_rta_curl->error ."</p>"; 
echo "<p>errores:". implode("," , $json_rta_curl->errores) ."</p>";
AnteriorNotas de crédito / Notas de débitoSiguienteComprobantes de tipo: Factura de Crédito Electrónica MiPyme (FCE)

Última actualización