Para documentación en español, ver: http://www.sistemasagiles.com.ar/trac/wiki/ManualPyAfipWs (full user manual - documentation)

For more information in Spanish see: http://www.sistemasagiles.com.ar/trac/wiki/FacturaElectronicaExportacion

• Introduction
• Details
• Visual Basic (5/6) COM Example
• RECEX Command Line tool
• RECEX Command line parameters
• RECEX Configuration File (rece.ini)
• RECEX Usage
• RECEX File Format
• Invoice Header record
• Invoice line item detail (Detalle)
• Export licence/permit (Permisos de Exportación)
• Related invoice records (Comprobante Asociado)
• WSFEX/RECEX Parameter Tables
• Currencies (Monedas)
• Invoice Types (Tipos Comprobante)
• Export Types (Tipos Exportación)
• Invoice Language (Idiomas)
• Measurement Units (Unidades de medida)
• INCOTERMs
• Destination Country (Pais Destino)
• Destination Country CUIT (CUIT Pais Destino)

Introduction

WSFEX is the webservice to authorize foreign trade invoices according AFIP (Argentina "IRS") regulations.

This webservice allows to authorize an invoice (i.e. get the CAE: Electronic Autorization Code) so it can be sent to the customer.

Invoice Class:

• E: sales to foreign customers (Exports)

AFIP General Resolutions:

• RG2485: General Regime
• RG2758: Foreign trade (Export operations)

Webservice:

• Current: WSFEX (a.k.a. version 0) available until 31/12/2011
• Future: WSFEXv1 (version 1, minor changes to WSFEX)

PyAfipWs Interface options:

• COM Interface (windows only): CreateObject("WSFEX")
• Command-line communication tool: RECEX.EXE
• Python module: wsfex.py

Current Installer:

• Stable: all-in-one installer (recommended)
• Development: (new version not yet released)

Installers are for evaluation purposes only (testing - homologation). For production, consult our Commercial Support or see InstalacionCodigoFuente (Source Code Installation Instructions)

Details

Most modern programming languages in windows support COM Automation (a.k.a. Component Object Model, ActiveX DLL, similar to OCX controls) via CreateObject or similar function, and this interface exposes WSAA and WSFEv1 objects to be used directly from legacy programs.

Some known supported programming languages so far:

• Visual Basic Classic (5,6)
• Visual Basic .Net
• Visual Basic For Applications (MS Access, MS Excel, et. al.)
• Visual Fox Pro
• Delphi
• ABAP (SAP)
• Fujitsu NetCobol
• Powerbuilder
• X++ (Microsoft Dynamics)
• Genexus

If your programming language doesn't support COM, the interface has a Command Line Tool called RECE1 to perform invoice authorization using text files or DBF tables (see bellow).

Visual Basic (5/6) COM Example

The following code is a detailed example to explain main features and recommended process and data needed to authorize a valid electronic invoice:

' Simple example COM Interface with new WSFEX AFIP webservice
' As of RG758 (Foreign Trade - Export Operations)
' For a complete workflow see WSFEv1 Example
' 2010 (C) Mariano Reingart <reingart@gmail.com>
' License: GPLv3

' Create an internal invoice (do not call webservice yet):
ok = WSFEX.CrearFactura(tipo_cbte, punto_vta, cbte_nro, fecha_cbte, _
            imp_total, tipo_expo, permiso_existente, dst_cmp, _
            cliente, cuit_pais_cliente, domicilio_cliente, _
            id_impositivo, moneda_id, moneda_ctz, _
            obs_comerciales, obs, forma_pago, incoterms, _
            idioma_cbte)
    
' Add an invoice item:
ok = WSFEX.AgregarItem(codigo, ds, qty, umed, precio, imp_total)

' Add a export permission 
ok = WSFEX.AgregarPermiso(id_permiso, pais_dst)
        
' Add and related invoice 
ok = WSFEX.AgregarCmpAsoc(tipo_cbte_asoc, punto_vta_asoc, cbte_nro_asoc)

' Call WebService to get the CAE
cae = WSFEX.Authorize(id)

RECEX Command Line tool

RECEX is our tool that using text files for legacy programming languages in a simplified way, no user interaction is required, with the advantage that communication is done instantaneously using webservices, so CAE number is returned immediately, no further process is needed, and can be done in background automatically.

RECEX Command line parameters

• /ayuda: show help
• /prueba: generate a test invoice and get CAE for it, saving input and ouput files with sample values. DO NOT USE IN PRODUCTION.
• /ult: ask for invoice type and sale point, returns the last invoice number registered at AFIP
• /dummy: queries AFIP server status (the three servers should return OK if they are working properly)
• /debug: show extensive debug messages y and ask for confirmation prior sending the data to AFIP servers
• /formato: show input/output file format
• /get: recover previously authorized invoice, returns all informed data if available.
• /xml: save XML request and response messages

RECEX Configuration File (rece.ini)

Before start using RECE1 tool, you must generate your private key and certificate files, and then edit the file RECE.INI in the interface folder (i.e. C:\WSFEv1):

Section WSAA:

• CERT: path to the certificate file ()
• PRIVATEKEY: path to the private key file
• CUIT: CUIT of the company that generates the invoices
• URL: location of the webservice (uncomment removing # to use in production, if not, it connects to testing servers "homologacion")

Section WSFEX:

• ENTRADA: path to the input text file
• SALIDA: path to the ouput text file
• URL: location of the webservice (uncomment removing # to use in production, if not, it connects to testing servers "homologacion")

Sample configuration file (minimal):

[WSAA]
CERT=homo.crt
PRIVATEKEY=homo.key
##URL=https://wsaa.afip.gov.ar/ws/services/LoginCms

[WSFEX]
CUIT=30000000000
ENTRADA=entrada.txt
SALIDA=salida.txt
##URL=https://servicios1.afip.gov.ar/wsfex/service.asmx?WSDL

RECEX Usage

Sample usage (create a test invoice, show debug messages):

C:\PYAFIPWS>RECEX.EXE /debug /prueba
wsaa_url https://wsaahomo.afip.gov.ar/ws/services/LoginCms
wsfex_url https://wswhomo.afip.gov.ar/wsfex/service.asmx
Imp_total='250.0'
Incoterms='FOB'
Tipo_cbte='19'
Domicilio_cliente='Rua 76 km 34.5 Alagoas'
Moneda_ctz='3.875'
Id_impositivo='PJ54482221-l'
Fecha_cbte='20110616'
Cbte_nro='38'
Punto_vta='3'
Forma_pago='30 dias'
Obs='Sin observaciones'
Items='[{'Item': {'Pro_precio_uni': 125.0, 'Pro_umed': '7', 'Pro_ds': u'Producto
 Tipo 1 Exportacion MERCOSUR ISO 9001', 'Pro_total_item': 125.0, 'Pro_qty': 1.0,
 'Pro_codigo': u'PRO1'}}, {'Item': {'Pro_precio_uni': 125.0, 'Pro_umed': '7', 'P
ro_ds': u'Producto Tipo 2 Exportacion MERCOSUR ISO 9001', 'Pro_total_item': 125.
0, 'Pro_qty': 1.0, 'Pro_codigo': u'PRO2'}}]'
Tipo_expo='1'
Idioma_cbte='1'
Dst_cmp='203'
Permisos='[{'Permiso': {'Dst_merc': '225', 'Id_permiso': u'99999AAXX999999A'}}]'

Cuit_pais_cliente='50000000016'
Moneda_Id='DOL'
Permiso_existente='S'
Cliente='Joao Da Silva'
Obs_comerciales='Observaciones comerciales'
id: 99000000001257
Facturar?S
ID: 99000000001257 CAE: 61243000517776 Obs:  Reproceso: N

Normal usage (don't show debug messages nor make test invoice, but save XML files):

C:\WSFEv1>RECEX.EXE /xml
ID: 99000000001257 CAE: 61243000517776 Obs:  Reproceso: S

Usage to query last invoice informed to AFIP and recover previously sent invoice data (Tipo de Comprobante: invoice type, Punto de Venta: point of sale, Ultimo numero: last invoice number, Fecha: date):

C:\WSFEv1>RECEX.EXE /ult
Consultar ultimo numero:
Tipo de comprobante: 19
Punto de venta: 3
Ultimo numero:  38
Fecha:  20110616

C:\WSFEv1>RECEX.EXE  /get
Recuperar comprobante:
Tipo de comprobante: 19
Punto de venta: 3
Numero de comprobante: 38
imp_total = 250
fch_cbte = 20110616
fch_venc_cae = 20110626
cuit = 50000000016
obs = Sin observaciones
cae = 61243000517776

RECEX File Format

Input and output files have the same format, only returned fields are completed in the output file (cae, fch_venc_cae, resultado, errmsg, etc.)

Important: you must check current format with /formato parameter because you can have a another version with different field structure.

Records must be separated by line feed (LF) and/or carriage return (CR) depending the operating system convention. Each record have a type in the first character (0: Invoice Header, 1: Invoice item detail, 2: Export license - export permit, 3: Related Invoices):

Invoice Header record

• Field: tipo_reg (record type) Position: 1 Lenght: 1 Type: Numeric Decimals:
• Field: fecha_cbte (invoice date) Position: 2 Lenght: 8 Type: AlphaNumeric Decimals:
• Field: tipo_cbte (invoice type) Position: 10 Lenght: 2 Type: Numeric Decimals:
• Field: punto_vta (point of sale) Position: 12 Lenght: 4 Type: Numeric Decimals:
• Field: cbte_nro (invoice number) Position: 16 Lenght: 8 Type: Numeric Decimals:
• Field: tipo_expo (export type) Position: 24 Lenght: 1 Type: Numeric Decimals:
• Field: permiso_existente (has export permit/license, 'S': Yes, 'N': No, '': not applicable) Position: 25 Lenght: 1 Type: AlphaNumeric Decimals:
• Field: dst_cmp (destination country code) Position: 26 Lenght: 3 Type: Numeric Decimals:
• Field: cliente (customer name) Position: 29 Lenght: 200 Type: AlphaNumeric Decimals:
• Field: cuit_pais_cliente (customer country CUIT) Position: 229 Lenght: 11 Type: Numeric Decimals:
• Field: domicilio_cliente (customer address) Position: 240 Lenght: 300 Type: AlphaNumeric Decimals:
• Field: id_impositivo (customer tax id) Position: 540 Lenght: 50 Type: AlphaNumeric Decimals:
• Field: imp_total (total amount) Position: 590 Lenght: 15 Type: Importe Decimals: 3
• Field: moneda_id (currency code) Position: 605 Lenght: 3 Type: AlphaNumeric Decimals:
• Field: moneda_ctz (currency quotation) Position: 608 Lenght: 10 Type: Importe Decimals: 6
• Field: obs_comerciales (commercial remarks) Position: 618 Lenght: 1000 Type: AlphaNumeric Decimals:
• Field: obs (general remarks / invoice description) Position: 1618 Lenght: 1000 Type: AlphaNumeric Decimals:
• Field: forma_pago (payment method description) Position: 2618 Lenght: 50 Type: AlphaNumeric Decimals:
• Field: incoterms (incoterms code) Position: 2668 Lenght: 3 Type: AlphaNumeric Decimals:
• Field: incoterms_ds (incoterms description) Position: 2671 Lenght: 20 Type: AlphaNumeric Decimals:
• Field: idioma_cbte (invoice language) Position: 2691 Lenght: 1 Type: AlphaNumeric Decimals:
• Field: cae Position: 2692 Lenght: 14 Type: Numeric Decimals:
• Field: fecha_vto (due date) Position: 2706 Lenght: 8 Type: AlphaNumeric Decimals:
• Field: resultado (result, A: Aproved, R: rejected) Position: 2714 Lenght: 1 Type: AlphaNumeric Decimals:
• Field: reproceso (reprocess previos sent invoice, blank: not needed, S: succed, N: fail, check data) Position: 2715 Lenght: 1 Type: AlphaNumeric Decimals:
• Field: motivos_obs (observation message) Position: 2716 Lenght: 40 Type: AlphaNumeric Decimals:
• Field: id (invoice unique identification number) Position: 2756 Lenght: 15 Type: Numeric Decimals:
• Field: fch_venc_cae (cae due date) Position: 2771 Lenght: 8 Type: AlphaNumeric Decimals:

Invoice line item detail (Detalle)

• Field: tipo_reg (record type, value: 1) Position: 1 Lenght: 1 Type: Numeric Decimals:
• Field: codigo (product code) Position: 2 Lenght: 30 Type: AlphaNumeric Decimals:
• Field: qty (quantity) Position: 32 Lenght: 12 Type: Importe Decimals:
• Field: umed (measure unit code, see table) Position: 44 Lenght: 2 Type: Numeric Decimals:
• Field: precio (product price) Position: 46 Lenght: 12 Type: Importe Decimals: 3
• Field: imp_total (total amount = qty*price) Position: 58 Lenght: 14 Type: Importe Decimals: 3
• Field: ds (product description) Position: 72 Lenght: 4000 Type: AlphaNumeric Decimals:

Export licence/permit (Permisos de Exportación)

• Field: tipo_reg (record type, value: 2) Position: 1 Lenght: 1 Type: Numeric Decimals:
• Field: id_permiso (export licence or permit identification number) Position: 2 Lenght: 16 Type: AlphaNumeric Decimals:
• Field: dst_merc (destination country code) Position: 18 Lenght: 3 Type: Numeric Decimals:

Related invoice records (Comprobante Asociado)

• Field: tipo_reg (record type, value: 3) Position: 1 Lenght: 1 Type: Numeric Decimals: Value: 3 (always)
• Field: tipo (invoice type, see table) Position: 2 Lenght: 3 Type: Numeric Decimals:
• Field: pto_vta (sale point number) Position: 5 Lenght: 4 Type: Numeric Decimals:
• Field: nro (invoice number) Position: 9 Lenght: 8 Type: Numeric Decimals:

WSFEX/RECEX Parameter Tables

This webservice is parametrized with the following tables:

Currencies (Monedas)

Invoice Types (Tipos Comprobante)

Export Types (Tipos Exportación)

Invoice Language (Idiomas)

Measurement Units (Unidades de medida)

INCOTERMs

Destination Country (Pais Destino)

Destination Country CUIT (CUIT Pais Destino)